▣ DEVELOPER TOOLS · SECURITY & PRIVACY

Extract User Agent API

Hosted on ApyHub

What it does

User Agent Parser turns a raw HTTP user_agent string into structured browser, platform, device, and engine data. Send the header value you receive from a request, and get back the parsed client details you can use in analytics, support, or bot filtering.

The request body accepts one field: user_agent. The response wraps everything under data, with required browser, platform, device, and engine objects. Browser data includes the browser name, type, version, major and minor version, and an is_bot flag. Platform data includes the OS name, short code, version, and icon. Device data includes the device name, type, brand, code name, and icon. Engine data includes the rendering engine name and version.

Use User Agent Parser when you need to segment traffic by browser or operating system, detect desktop versus mobile clients, or flag automated requests. It is a direct fit for request logging pipelines, fraud checks, and product analytics that need a normalized view of the client behind each HTTP request.

POST

Parse User-Agent string

https://api.eu.apyhub.com/apyhub/parse-user-agent-string

QUICKSTART

GUIDE

Quickstart

Parse a raw User-Agent string to identify the browser, platform, device, and engine.

curl -X POST "https://api.eu.apyhub.com/apyhub/parse-user-agent-string" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "user_agent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36"
}'

What you'll get back

Returns a JSON object with a data object containing browser, platform, device, and engine objects.

{
  "data": {
    "browser": {},
    "platform": {},
    "device": {},
    "engine": {}
  }
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Parses a raw HTTP User-Agent string from the request body and returns a structured breakdown of the browser, platform, device, and engine details it detects.

Request Body

Parameter	Type	Description
user_agent	String	Raw HTTP User-Agent header value to parse.

Response

Returns a JSON object with a data object field. The data object contains the parsed browser, platform, device, and engine objects.

Parameter	Type	Description
data	Object	Parsed user-agent details. Contains `browser`, `platform`, `device`, and `engine`.
data.browser	Object	Browser details.
data.browser.icon	String	Browser icon URL.
data.browser.name	String	Browser name.
data.browser.type	String	Browser type.
data.browser.is_bot	Boolean	Indicates whether the user agent is identified as a bot. The schema also allows a string value.
data.browser.version	String	Full browser version.
data.browser.major_version	String	Major browser version.
data.browser.minor_version	String	Minor browser version.
data.platform	Object	Platform details.
data.platform.icon	String	Platform icon URL.
data.platform.name	String	Platform name.
data.platform.short	String	Short platform code.
data.platform.version	String	Platform version.
data.device	Object	Device details.
data.device.icon	String	Device icon URL.
data.device.name	String	Device name.
data.device.type	String	Device type.
data.device.brand	String	Device brand.
data.device.code_name	String	Device code name.
data.engine	Object	Engine details.
data.engine.name	String	Engine name.
data.engine.version	String	Engine version.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLAI-ready Clean Data Extractor APIApyHub CALLIngredient Parser From Text APIIngredients API CALLAI Text Syntax Analysis APIApyHub CALLExtract Structured Data APISumalya APIs

From the blog

Reads that touch this API.

How AI Agents Use APIs: A Beginner's GuideSep 15, 2026 Web Data Extraction: Use Cases and ApproachesJul 9, 2026 Top Tools, APIs and Use Cases for Extracting Text from Any WebsiteAug 10, 2026 A Developer’s Guide to Searching and Extracting Company Data ProgrammaticallyAug 7, 2026