User-Agent fields
Here are the fields and descriptions for responses associated with the user-agent parsing endpoints.
| Field | Description | | user_agent → header | The raw User-Agent string that is extract from the user request. |
| user_agent → name | The name of the actual "Browser" that was used. |
| user_agent → type | The type of the actual "Browser" that was used. Here is a list of possible values:- browser: a regular browser.
- browser-webview: a regular browser being used as part of 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.
- null: we don't know.
- 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 "Browser" (i.e. ask a question and the page is read aloud).
|
| user_agent → version | The version of the actual "Browser" that was used. |
| user_agent → version_major | The version major of the actual "Browser" that was used. |
| user_agent → device → brand | The brand of the hardware that was used. |
| user_agent → device → name | The name of the hardware that was used. |
| user_agent → device → type | The type of the hardware that was used. Here is a list of possible values:- anonymized: in case the User-Agent has been altered by an anonymization software.
- desktop: the device is assessed as a Desktop/Laptop class device.
- ereader: similar to a tablet yet in most cases with an e-ink screen.
- game-console: "fixed" game systems like the PlayStation and Xbox.
- hacker: in case scripting is detected in the User-Agent string, also fallback in really broken situations.
- handheld-game-console: "mobile" game systems like the 3DS.
- mobile: a device that is mobile yet we do not know if it is a ereader/tablet/phone or watch.
- null: we really don't know, these are usually User-Agents that look normal yet contain almost no information about the device.
- phone: a mobile device with a small screen (usually lower than 7").
- robot: a robot that visits the site.
- robot-imitator: a robot that visit the site pretending it is a robot like Google, but they are not.
- robot-mobile: a robot that visits the site and want to be seen as a mobile visitor.
- set-top-box: a connected device that allows interacting via a TV sized screen.
- tablet: a mobile device with a rather large screen (usually greater than 7").
- tv: similar to set-top box yet here this is built into the TV.
- virtual-reality: a mobile device with a VR capabilities.
- voice: a voice driven device (i.e. ask a question and the page is read aloud).
- watch: a mobile device with a tiny screen (usually lower than 2").
|
| user_agent → engine → name | The name of the underlying core that converts the 'HTML' into a visual/interactive. |
| user_agent → engine → type | The type of the underlying core that converts the 'HTML' into a visual/interactive. Here is a list of possible 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 spidering the site.
- null: we don't know.
|
| user_agent → engine → version | The version of the underlying core that converts the 'HTML' into a visual/interactive. |
| user_agent → os → name | The name of the resulting OS. |
| user_agent → os → type | The type of the resulting OS. Here is a list of possible values:- cloud: looks like a thing that runs in a cloud environment.
- desktop: the type of OS you would run on a Desktop or Laptop.
- embedded: apparently 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 type of OS you would run on a phone, tablet or watch.
- null: we don't known.
|
| user_agent → os → version | The version of the resulting OS. |