Sign in

v1

latestSwagger 2.02026-07-132830204.5 KB
Data Tools

UA Lookup

Parse, validate and get detailed user-agent information from a user agent string or from client hints

get/ua-lookup

Query parameters

uastring required

The user-agent string to lookup. For client hints this corresponds to the 'sec-ch-ua' header or you can also pass the JSON data directly from the 'navigator.userAgentData.getHighEntropyValues()' JavaScript API

ua-versionstring

For client hints this corresponds to the 'sec-ch-ua-full-version' header

ua-platformstring

For client hints this corresponds to the 'sec-ch-ua-platform' header

ua-platform-versionstring

For client hints this corresponds to the 'sec-ch-ua-platform-version' header

ua-mobilestring

For client hints this corresponds to the 'sec-ch-ua-mobile' header

device-modelstring

For client hints this corresponds to the 'sec-ch-ua-model' header. <br> You can also use this parameter to lookup a device directly by its model name, model code or hardware code, on android you can get the model name from: https://developer.android.com/reference/android/os/Build.html#MODEL

device-brandstring

This parameter is only used in combination with 'device-model' for direct device lookups without any user-agent data. Set this to the brand or manufacturer name, this is required for accurate device detection with ambiguous model names. On android you can get the device brand from: https://developer.android.com/reference/android/os/Build#MANUFACTURER

ua-archstring

For client hints this corresponds to the 'sec-ch-ua-arch' header

ua-bitnessstring

For client hints this corresponds to the 'sec-ch-ua-bitness' header

ua-form-factorsstring

For client hints this corresponds to the 'sec-ch-ua-form-factors' header

Response

OK

uastring required

The user agent string

typestring required

The user agent type, possible values are: <br> <ul> <li>desktop</li> <li>phone</li> <li>tablet</li> <li>wearable</li> <li>tv</li> <li>console</li> <li>email</li> <li>library</li> <li>robot</li> <li>unknown</li> </ul>

namestring required

The client software name / user agent name

versionstring required

The user agent software full version

version-majorstring required

The user agent software major version

browser-enginestring required

For web browsers which underlying browser engine does it use

browser-releasestring required

For web browsers which year was this browser version released

osstring required

The full operating system name

os-familystring required

The operating system family. The major OS families are: Android, Windows, macOS, iOS, Linux

os-versionstring required

The operating system full version

os-version-majorstring required

The operating system major version

is-mobileboolean required

Is this a mobile device (e.g. a phone or tablet)

is-webviewboolean required

Is this a WebView or embedded web browser. This includes mobile and desktop apps using WebViews

device-brandstring required

The device brand / manufacturer

device-modelstring required

The device model

device-model-codestring required

The device model code

device-releasestring required

The year when this device model was released

device-pricenumber double required

The average device price on release in USD

device-resolutionstring required

The device display resolution in physical pixels (e.g. 720x1280)

device-ppinumber double required

The device display PPI (pixels per inch)

device-pixel-rationumber double required

The device display pixel ratio (the ratio of the resolution in physical pixels to the resolution in CSS pixels)

device-width-pxnumber double required

The device display width in CSS 'px'

device-height-pxnumber double required

The device display height in CSS 'px'

is-currentboolean required

For web browsers is the version up-to-date with the current stable release (+/- one version)

is-ua-frozenboolean required

For chrome/chromium based browsers is this user agent string frozen and requires client hints for more accurate details. For more information see <a href="https://www.chromium.org/updates/ua-reduction/">user-agent reduction</a> and to test a browser for client hints go to the <a href="https://www.neutrinoapi.com/client-hints-analyzer/">client hints analyzer</a> test page

device-width-mminteger required

The device display width in millimeters

device-height-mminteger required

The device display height in millimeters

Example response

{
  "browser-engine": "Blink",
  "browser-release": "2020",
  "device-brand": "Samsung",
  "device-height-mm": 157,
  "device-height-px": 1066,
  "device-model": "Galaxy S21 Ultra 5G",
  "device-model-code": "SM-G9980U1",
  "device-pixel-ratio": 3,
  "device-ppi": 515,
  "device-price": 1400,
  "device-release": "2021",
  "device-resolution": "1440x3200",
  "device-width-mm": 70,
  "device-width-px": 480,
  "is-current": false,
  "is-mobile": true,
  "is-ua-frozen": false,
  "is-webview": false,
  "name": "Chrome",
  "os": "Android 11",
  "os-family": "Android",
  "os-version": "11",
  "os-version-major": "11",
  "type": "phone",
  "ua": "Mozilla/5.0 (Linux; Android 11; SM-G9980U1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.101 Mobile Safari/537.36",
  "version": "87.0.4280.101",
  "version-major": "87"
}