IPGeolocation.io · JSON Structure

User Agent User Agent Response Structure

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

Type: object Properties: 8
GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

UserAgentResponse is a JSON Structure definition published by IPGeolocation.io, describing 8 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

user_agent_string name type version version_major device engine operating_system

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-structure/user-agent-user-agent-response-structure.json",
  "name": "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": "??"
        }
      }
    }
  }
}