latestOpenAPI 3.1.02026-08-1562940.4 KB

26f6ef332981

Ipregistry User-Agent API

Batch Parse User-Agents

Initiates user-agent parsing using the provided list of user agents in JSON format from the body payload. User-Agent parsing allows detecting any browser, device & OS in real-time to bring user experience to perfection (e.g. native app download, tailored advertising, crawler protection, and more). The request costs as many credits as user-agents specified plus one.

post/user_agent

Query parameters

paramsobject required

The request parameters from the POST request. If 'format' query parameter is set to 'xml', the response will be in XML format.

Request body

string[] required

Response

Successful operation

headerstring

The raw User-Agent string extracted from the request.

namestring

The name of the browser.

typestring

The browser classification: browser, browser-webview, cloud-application, email-client, hacker, mobile-app, robot, robot-mobile, special, testclient, or voice.

versionstring

The browser version number.

version_majorstring

The major version number of the browser.

Example response

{
  "header": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
  "name": "Chrome",
  "type": "browser",
  "device": {
    "brand": "Apple",
    "name": "Linux Desktop",
    "type": "desktop"
  },
  "engine": {
    "name": "Blink",
    "type": "browser"
  },
  "os": {
    "name": "Linux",
    "type": "desktop"
  }
}