Get the information found in a set of User Agents.

v1.0.0

What

Get the information found in the list of User Agents passed as argument. This information includes:

Type
Render Engine
Version
Vendor
Operating System
Device
How common is the agent worldwide

Parameters

A list of User Agents are required in the body of the request.

Result

The result contains a list of the result for each User Agent, with the following data set:

The result is a JSON object with the following structure:

self: the URI of the API call
string: The full user agent string passed as argument.
classification: The classification of the user agent. It can be one of the following: CRAWLER, CLIENT, UNKNOWN.
type: An URI to the type of user agent used to identify the client (browser, bot, crawler, etc.).
agent: Name of the agent and the version, if any.
engine: Agent render engine.
version: Version of the agent.
latest: Latests known version of the agent.
family: URI to the family of the agent.
vendor: URI to the vendor or company that produces the agent.
os: URI to the operating system used by the agent.
device: URI to the device used by the agent.
frequent: If the agent is frequently used worlwide or not. The values are COMMON, RARE, and UNKNOWN.

Errors

The endpoint will return the API Global errors described in the API description.

Input

{
  "type": "array",
  "items": {
    "type": "string"
  }
}

Output

{
  "type": "object",
  "required": [
    "results",
    "self"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "string",
          "classification",
          "type",
          "agent",
          "engine",
          "version",
          "latest",
          "family",
          "vendor",
          "os",
          "device",
          "frequent"
        ],
        "properties": {
          "agent": {
            "type": "string"
          },
          "classification": {
            "type": "string",
            "enum": [
              "CRAWLER",
              "CLIENT",
              "UNKNOWN"
            ]
          },
          "device": {
            "type": "string"
          },
          "engine": {
            "type": "string"
          },
          "family": {
            "type": "string"
          },
          "frequent": {
            "type": "string",
            "enum": [
              "COMMON",
              "RARE",
              "VERY_RARE",
              "UNKNOWN"
            ]
          },
          "latest": {
            "type": "string"
          },
          "os": {
            "type": "string"
          },
          "self": {
            "type": "string"
          },
          "string": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "vendor": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        }
      }
    },
    "self": {
      "type": "string"
    }
  }
}