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