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": "??"
        }
      }
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/user-agent-user-agent-response-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.