User Agent Parser — parse browser and device data

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.

Quickstart

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

curl -X POST "http://localhost:8080/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"
}'

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

Body

Name

Type

Description

bodyREQUIRED

object

—

Extract User Agent API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return