user_agent.header string
The raw User-Agent string extracted from the request.
Example "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
User-Agent Response Fields
The user-agent parsing endpoints and the origin IP lookup return the fields below. Examples are illustrative values, not one single response.
No field matches . Try a key such as is_vpn or a word such as currency.
user_agent
Browser
The client software that sent the request.
user_agent.name string
The name of the browser (or other client) that was used.
Example "Chrome"
user_agent.type string
The type of client that was used.
null when it cannot be determined. Values
browser- a regular browser
browser-webview- a regular browser used inside a mobile app
cloud-application- something running in a cloud (but not a regular robot)
email-client- an email application
hacker- a hacker, so it can really be anything
mobile-app- a mobile app
robot- a robot that wants to be treated as a desktop device
robot-mobile- a robot that wants to be treated as a mobile device
special- something special we cannot fully classify
testclient- a website testing tool
voice- a voice-driven client (ask a question and the page is read aloud)
Example "browser"
user_agent.version string
The version of the client that was used.
Example "131.0.0.0"
user_agent.version_major string
The major version of the client that was used.
Example "131"
user_agent.device
Device
The hardware the client runs on.
user_agent.device.brand string
The brand of the hardware that was used.
user_agent.device.name string
The name of the hardware that was used.
Example "Linux Desktop"
user_agent.device.type string
The type of hardware that was used.
null when it cannot be determined, usually for User-Agents that look normal but contain almost no information about the device. Values
anonymized- the User-Agent was altered by anonymization software
desktop- a desktop or laptop class device
ereader- similar to a tablet, in most cases with an e-ink screen
game-console- "fixed" game systems like the PlayStation and Xbox
hacker- scripting was detected in the User-Agent string; also the fallback for really broken values
handheld-game-console- "mobile" game systems like the 3DS
mobile- a mobile device, without knowing whether it is an e-reader, tablet, phone or watch
phone- a mobile device with a small screen (usually under 7")
robot- a robot that visits the site
robot-imitator- a robot pretending to be a known robot like Google, but it is not
robot-mobile- a robot that wants to be seen as a mobile visitor
set-top-box- a connected device used through a TV-sized screen
tablet- a mobile device with a rather large screen (usually over 7")
tv- like a set-top box, but built into the TV
virtual-reality- a device with VR capabilities
voice- a voice-driven device (ask a question and the page is read aloud)
watch- a mobile device with a tiny screen (usually under 2")
Example "desktop"
user_agent.engine
Engine
The layout engine that turns HTML into what the user sees.
user_agent.engine.name string
The name of the layout engine.
Example "Blink"
user_agent.engine.type string
The type of the layout engine.
null when it cannot be determined. Values
browser- a regular browser
mobile-app- a mobile app, which probably includes a regular web browser
hacker- a hacker, so it can really be anything (e.g. script injections)
robot- a robot crawling the site
Example "browser"
user_agent.engine.version string
The version of the layout engine.
The major version of the layout engine.
Example "131"
user_agent.os
Operating system
The operating system the client runs on.
user_agent.os.name string
The name of the operating system.
Example "Linux"
user_agent.os.type string
The type of the operating system.
null when it cannot be determined. Values
cloud- something that runs in a cloud environment
desktop- the kind of OS you would run on a desktop or laptop
embedded- embedded into something like a TV
game-console- a game console like a PlayStation or Xbox
hacker- a hacker, so it can really be anything (e.g. script injection)
mobile- the kind of OS you would run on a phone, tablet or watch
Example "desktop"
user_agent.os.version string
The version of the operating system.