User-Agent API

Getting started

Subscribe, copy your secret key, and parse your first User-Agent.

The Syndaq User-Agent API parses a User-Agent string into browser, OS, device type, engine, and bot flags. Responses are structured JSON over HTTPS.

v1 scope: parsing only. The API does not fingerprint hardware, confirm the client is genuine, or track users across requests.

What you need

  1. A User-Agent plan from the Syndaq API catalog.
  2. A secret key (ua_sec_) from the Syndaq client area after your order is provisioned.

User-Agent lookups are server-side only. Send your secret key from your backend or trusted worker. Do not embed it in client-side code, mobile apps, or public repositories.

Base URL

All User-Agent endpoints are served from:

https://api.syndaq.com/v1/useragent/

Quick start

Replace ua_sec_YOUR_SECRET_KEY with the secret shown in Services for your User-Agent subscription.

curl -sS "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"

You can also pass user_agent as a query parameter or send a JSON body with ua / user_agent.

A successful response includes browser, os, device_type, is_bot, and engine.

How lookups work

StepWhat happens
1Authenticate with your secret key.
2Send a User-Agent string to the lookup endpoint.
3Receive JSON with the parsed fields (including a cached flag when Syndaq already holds a recent result).

Empty or missing User-Agent values return a clear validation error.

Manage your subscription

Sign in to the Syndaq client area and open Services. Select your User-Agent service to:

  • View usage and remaining monthly quota
  • Copy or rotate your secret key
  • Configure optional IP allowlists for API access

Next steps