All APIs Syndaq User-Agent

Data API

Turn User-Agent strings into structured device intel.

Extract browser, OS, device type, engine, and bot flags from a single string. The Syndaq User-Agent API returns normalized JSON—built for analytics, fraud rules, and client fingerprinting.

At a glance

  • 3 REST endpoints
  • JSON Request & response
  • HTTPS TLS required
  • Free tier available Starting price

Use cases

Where teams use Syndaq User-Agent

Analytics enrichment

Attach browser and OS dimensions to events without shipping a client-side parser.

Fraud signals

Flag bot-like agents on signup, login, and payment flows.

Device routing

Route mobile vs desktop traffic to the right experience or support queue.

Security logging

Normalize User-Agent fields in SIEM and audit trails for faster review.

Integration

Up and running in three steps

1

Get an API key

Subscribe to a User-Agent plan and copy your ua_sec_ secret key from the client area.

2

Pass a User-Agent

Call /v1/useragent/lookup with ?ua= (URL-encoded) or a JSON body.

3

Use structured fields

Branch on browser, OS, device_type, and is_bot in your application logic.

Example

Copy, paste, ship

Every response includes a request_id for support correlation. Rate limit and quota headers are returned on authenticated routes so you can backoff gracefully.

Authenticated with your Syndaq secret key over HTTPS. v1 parses the User-Agent string only—it does not fingerprint hardware or confirm the client is genuine.

Request
curl -s "https://api.syndaq.com/v1/useragent/lookup?ua=Mozilla%2F5.0%20(Windows%20NT%2010.0%3B%20Win64%3B%20x64)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F126.0.0.0%20Safari%2F537.36" \
  -H "Authorization: Bearer ua_sec_YOUR_SECRET_KEY"
Response
{
  "success": true,
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
  "cached": true,
  "browser": { "name": "Chrome", "version": "126.0.0.0" },
  "os": { "name": "Windows", "version": "10.0" },
  "device_type": "desktop",
  "is_bot": false,
  "engine": "Blink",
  "request_id": "f1a2b3c4d5e6789012345678901234ab"
}

Reference

API endpoints

Included with your Syndaq User-Agent plan.

Method Path Description
GET /v1/useragent/lookup Parse a User-Agent via ?ua= query parameter.
POST /v1/useragent/lookup Parse a User-Agent from a JSON body.
GET /v1/useragent/status Returns plan limits and quota for the authenticated key.

Pricing

Plans for every stage

Transparent limits. Upgrade when your traffic grows—no surprise overages without a plan change.

Starter

Free

Development and light production lookups.

  • 120 requests / minute
  • 10,000 lookups / month
  • Secret key authentication
  • User-Agent parse JSON REST API
  • Browser, OS, device & bot signals
  • Rate limit & quota headers
Get started

Enterprise

monthly
$99.00 USD

High-volume lookups with priority limits.

  • 3,000 requests / minute
  • Unlimited monthly lookups
  • Secret key authentication
  • User-Agent parse JSON REST API
  • Browser, OS, device & bot signals
  • Rate limit & quota headers
Get started

FAQ

Common questions

Send your ua_sec_ secret key as a Bearer token in the Authorization header on every request to https://api.syndaq.com.

A truncated user_agent sample plus browser and OS name/version, device_type, is_bot, and engine—as structured JSON.

Yes. Plans include per-minute rate limits and monthly quotas with standard X-RateLimit and X-Quota response headers.

Ready to integrate Syndaq User-Agent?

Pick a plan, create your keys in the client area, and start calling the API in minutes.

Choose a plan Ask a question