User Agent Parser — parse browser and device data

Extract User Agent API

What it does

User Agent Parser turns a raw HTTP User-Agent header into structured browser, platform, device, and engine data. Send a single user_agent string in the request body, and get parsed metadata back in data.

Use it when you need to identify the client behind a request without maintaining your own user-agent parsing logic. The response includes browser details such as name, version, major and minor version, whether it looks like a bot, plus platform fields like name, short code, and version.

You also get device and engine information. Device data can include the device name, type, brand, code name, and an icon URL. Engine data includes the engine name and version. That makes this useful for analytics pipelines, bot detection, device-level reporting, and request logging where you want consistent client classification.

User Agent Parser is a simple way to normalize browser and device metadata from messy header strings into a predictable JSON response.

curl -X POST "http://localhost:8080/apyhub/parse-user-agent" \ -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/120.0.0.0 Safari/537.36"}'

About this endpoint

What it does

Parses a raw HTTP User-Agent string and returns structured information about the detected browser, platform, device, and engine.

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 structured detection results for browser, platform, device, and engine.

Parameter	Type	Mandatory	Description
data	Object	Yes	Parsed user-agent details.
data.browser	Object	Yes	Browser information object.
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	Browser version.
data.browser.major_version	String	No	Browser major version.
data.browser.minor_version	String	No	Browser minor version.
data.platform	Object	Yes	Platform information object.
data.platform.icon	String	No	Platform icon URL.
data.platform.name	String	No	Platform name.
data.platform.short	String	No	Platform short code.
data.platform.version	String	No	Platform version.
data.device	Object	Yes	Device information object.
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 information object.
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

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return