Analytics enrichment
Attach browser and OS dimensions to events without shipping a client-side parser.
Data API
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
Use cases
Attach browser and OS dimensions to events without shipping a client-side parser.
Flag bot-like agents on signup, login, and payment flows.
Route mobile vs desktop traffic to the right experience or support queue.
Normalize User-Agent fields in SIEM and audit trails for faster review.
Integration
Subscribe to a User-Agent plan and copy your ua_sec_ secret key from the client area.
Call /v1/useragent/lookup with ?ua= (URL-encoded) or a JSON body.
Branch on browser, OS, device_type, and is_bot in your application logic.
Example
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.
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"
{
"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
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
Transparent limits. Upgrade when your traffic grows—no surprise overages without a plan change.
Development and light production lookups.
Higher throughput for production apps.
High-volume lookups with priority limits.
FAQ
Pick a plan, create your keys in the client area, and start calling the API in minutes.
Choose a plan Ask a question