IPGeolocation.io · Schema

UserAgentResponse

Parsed user agent details including browser, device, layout engine, and operating system information. Also indicates bots, crawlers, or malicious user agent strings.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name	Type	Description
user_agent_string	string	The raw user agent string that was parsed.
name	string	Name of the detected agent (e.g. browser name, bot name, or `"Hacker"` if the string is malformed or contains injected scripts).
type	string	Type of the detected user agent. See possible values in the documentation.
version	string	Full version string of the detected agent.
version_major	string	Major version of the detected agent.
device	object	Hardware device information extracted from the user agent string.
engine	object	Layout engine information extracted from the user agent string.
operating_system	object	Operating system information extracted from the user agent string.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-schema/user-agent-user-agent-response-schema.json",
  "title": "UserAgentResponse",
  "description": "Parsed user agent details including browser, device, layout engine, and\noperating system information. Also indicates bots, crawlers, or malicious\nuser agent strings.\n",
  "type": "object",
  "properties": {
    "user_agent_string": {
      "type": "string",
      "description": "The raw user agent string that was parsed.",
      "example": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9"
    },
    "name": {
      "type": "string",
      "description": "Name of the detected agent (e.g. browser name, bot name, or `\"Hacker\"`\nif the string is malformed or contains injected scripts).\n",
      "example": "Safari"
    },
    "type": {
      "type": "string",
      "description": "Type of the detected user agent. See possible values in the documentation.\n",
      "example": "Browser"
    },
    "version": {
      "type": "string",
      "description": "Full version string of the detected agent.",
      "example": "9.0.2"
    },
    "version_major": {
      "type": "string",
      "description": "Major version of the detected agent.",
      "example": "9"
    },
    "device": {
      "type": "object",
      "description": "Hardware device information extracted from the user agent string.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the device (e.g. model name or manufacturer).",
          "example": "Apple Macintosh"
        },
        "type": {
          "type": "string",
          "description": "Type of the device. See possible values in the documentation.\n",
          "example": "Desktop"
        },
        "brand": {
          "type": "string",
          "description": "Brand or manufacturer of the device.",
          "example": "Apple"
        },
        "cpu": {
          "type": "string",
          "description": "CPU architecture or model of the device. May be `\"Unknown\"`.",
          "example": "Intel"
        }
      }
    },
    "engine": {
      "type": "object",
      "description": "Layout engine information extracted from the user agent string.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the layout engine (e.g. `\"AppleWebKit\"`, `\"Blink\"`, `\"Gecko\"`).",
          "example": "AppleWebKit"
        },
        "type": {
          "type": "string",
          "description": "Type of the layout engine. See possible values in the documentation.\n",
          "example": "Browser"
        },
        "version": {
          "type": "string",
          "description": "Full version string of the layout engine. May be `\"??\"` if unknown.",
          "example": "601.3.9"
        },
        "version_major": {
          "type": "string",
          "description": "Major version of the layout engine. May be `\"??\"` if unknown.",
          "example": "601"
        }
      }
    },
    "operating_system": {
      "type": "object",
      "description": "Operating system information extracted from the user agent string.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the operating system.",
          "example": "Mac OS"
        },
        "type": {
          "type": "string",
          "description": "Type of the operating system. See possible values in the documentation.\n",
          "example": "Desktop"
        },
        "version": {
          "type": "string",
          "description": "Full version string of the operating system. May be `\"??\"` if unknown.",
          "example": "10.11.2"
        },
        "version_major": {
          "type": "string",
          "description": "Major version of the operating system. May be `\"??\"` if unknown.",
          "example": "10.11"
        },
        "build": {
          "type": "string",
          "description": "Build identifier of the operating system. May be `\"??\"` if unknown.",
          "example": "??"
        }
      }
    }
  }
}