SearchCtrl+K

User Agent Parser API Reference

Parse any User-Agent string to obtain detailed information about the browser, device, and operating system. Also detects crawlers, bots, and potential attack sources.

GEThttps://api.apifreaks.com/v1.0/user-agent/lookup

Test

The User Agent Parser API takes a User-Agent header and returns a structured JSON response with browser name, version, engine details, device information, and operating system data. Supports desktop, mobile, tablet, and crawler detection.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/user-agent/lookup' \
  -H 'User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:142.0) Gecko/20100101 Firefox/142.0' \
  -H 'X-apiKey: API-KEY'

Response

{
  "user_agent_string": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv: 142.0) Gecko/20100101 Firefox/142.0",
  "name": "Firefox",
  "type": "Browser",
  "version": "142.0",
  "version_major": "142",
  "device": {
    "name": "Linux Desktop",
    "type": "Desktop",
    "brand": "Unknown",
    "cpu": "Intel x86_64"
  },
  "engine": {
    "name": "Gecko",
    "type": "Browser",
    "version": "142.0",
    "version_major": "142"
  },
  "operating_system": {
    "name": "Ubuntu",
    "type": "Desktop",
    "version": "??",
    "version_major": "??",
    "build": "??"
  }
}

API Request

Query Parameters

The following query parameter can optionally be used.

formatoptionalStringdefault: json

Format of the response. Can be "json" or "xml".

Request Headers

The following header is included in your API request.

User-AgentoptionalString

user-agent string to parse

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the parsed user-agent data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.

user_agent_string

Stringmandatory

The raw User-Agent string

name

Stringmandatory

The name of the browser or crawler

type

Stringmandatory

The type (e.g. Browser, Robot, Hacker)

version

Stringmandatory

The full version string

version_major

Stringmandatory

The major version

name (String), type (String), brand (String), cpu (String)

name (String), type (String), version (String), version_major (String)

name (String), type (String), version (String), version_major (String), build (String)

Possible Values of The Device Type

Desktop

Stringmandatory

This device is a Desktop/Laptop

Mobile

Stringmandatory

This device is a mobile device however we are not sure if its a tablet, watch, e-reader or phone

Tablet

Stringmandatory

This device is a Tablet

Phone

Stringmandatory

This device is a mobile Phone

Watch

Stringmandatory

This device is a watch or device with tiny screen

Virtual Reality

Stringmandatory

This is VR capable mobile device

eReader

Stringmandatory

Device with e-ink screen

Set-top box

Stringmandatory

A connected device that can interact with TV screen

TV

Stringmandatory

Smart TV

Game Console

Stringmandatory

Fixed game consoles like PS and XBox

Handheld Game Console

Stringmandatory

Mobile game systems like the 3DS

Voice

Stringmandatory

A voice driven device that reads the page loud

Robot

Stringmandatory

Robot crawler

Robot Mobile

Stringmandatory

Mobile device Robot crawler

Robot Imitator

Stringmandatory

Robots that pretend to be Google or Bing crawlers but they usually are not official crawlers.

Hacker

Stringmandatory

Either the User Agent String is malformed or some kind of scripting is detected in it.

Anonymized

Stringmandatory

The User Agent has been altered by anonymization software.

Unknown

Stringmandatory

We can't extract the device information from the User Agent.

Possible Values of The Operating System Type

Desktop

Stringmandatory

A Desktop OS (Desktop/Laptop)

Mobile

Stringmandatory

A Mobile OS (Tablet/Mobile/Watch)

Game Console

Stringmandatory

Game Console like PlayStation

Embedded

Stringmandatory

An Embedded device (TV, RTOS etc)

Cloud

Stringmandatory

Something running in the cloud environment

Hacker

Stringmandatory

A Hacker

Anonymized

Stringmandatory

Explicitly hidden with some software

Unknown

Stringmandatory

We really don't know about this OS

Possible Values of The Engine Type

Browser

Stringmandatory

Regular Web Browser

Mobile App

Stringmandatory

A mobile app with webview or an app that includes regular browser

Hacker

Stringmandatory

Someone with malicious stuff in useragent string or malformed UA string

Robot

Stringmandatory

A web crawler

Unknown

Stringmandatory

We don't know anything about the identity of this device

Possible Values of The User-Agent Type

Browser

Stringmandatory

Regular Web Browser

Browser Webview

Stringmandatory

Regular browser being used in a mobile app

Mobile App

Stringmandatory

A mobile app accessing the website

Robot Mobile

Stringmandatory

A web crawler who want to be detected as mobile

Cloud Application

Stringmandatory

Something running in the cloud (can be web scrapper etc.)

Email Client

Stringmandatory

An email client

Voice

Stringmandatory

Voice enabled browser that reads out loud

Special

Stringmandatory

Something special we can't classify

Testclient

Stringmandatory

Website testing tool

Hacker

Stringmandatory

Someone with malicious stuff in useragent string or malformed UA string

Unknown

Stringmandatory

We don't know

User Agent Parser API Reference

Parse any User-Agent string to obtain detailed information about the browser, device, and operating system. Also detects crawlers, bots, and potential attack sources.

GEThttps://api.apifreaks.com/v1.0/user-agent/lookup

Test

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/user-agent/lookup' \
  -H 'User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:142.0) Gecko/20100101 Firefox/142.0' \
  -H 'X-apiKey: API-KEY'

Response

{
  "user_agent_string": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv: 142.0) Gecko/20100101 Firefox/142.0",
  "name": "Firefox",
  "type": "Browser",
  "version": "142.0",
  "version_major": "142",
  "device": {
    "name": "Linux Desktop",
    "type": "Desktop",
    "brand": "Unknown",
    "cpu": "Intel x86_64"
  },
  "engine": {
    "name": "Gecko",
    "type": "Browser",
    "version": "142.0",
    "version_major": "142"
  },
  "operating_system": {
    "name": "Ubuntu",
    "type": "Desktop",
    "version": "??",
    "version_major": "??",
    "build": "??"
  }
}

API Request

Query Parameters

The following query parameter can optionally be used.

formatoptionalStringdefault: json

Format of the response. Can be "json" or "xml".

Request Headers

The following header is included in your API request.

User-AgentoptionalString

user-agent string to parse

API Response Schema

user_agent_string

Stringmandatory

The raw User-Agent string

name

Stringmandatory

The name of the browser or crawler

type

Stringmandatory

The type (e.g. Browser, Robot, Hacker)

version

Stringmandatory

The full version string

version_major

Stringmandatory

The major version

name (String), type (String), brand (String), cpu (String)

name (String), type (String), version (String), version_major (String)

name (String), type (String), version (String), version_major (String), build (String)

Possible Values of The Device Type

Desktop

Stringmandatory

This device is a Desktop/Laptop

Mobile

Stringmandatory

This device is a mobile device however we are not sure if its a tablet, watch, e-reader or phone

Tablet

Stringmandatory

This device is a Tablet

Phone

Stringmandatory

This device is a mobile Phone

Watch

Stringmandatory

This device is a watch or device with tiny screen

Virtual Reality

Stringmandatory

This is VR capable mobile device

eReader

Stringmandatory

Device with e-ink screen

Set-top box

Stringmandatory

A connected device that can interact with TV screen

TV

Stringmandatory

Smart TV

Game Console

Stringmandatory

Fixed game consoles like PS and XBox

Handheld Game Console

Stringmandatory

Mobile game systems like the 3DS

Voice

Stringmandatory

A voice driven device that reads the page loud

Robot

Stringmandatory

Robot crawler

Robot Mobile

Stringmandatory

Mobile device Robot crawler

Robot Imitator

Stringmandatory

Robots that pretend to be Google or Bing crawlers but they usually are not official crawlers.

Hacker

Stringmandatory

Either the User Agent String is malformed or some kind of scripting is detected in it.

Anonymized

Stringmandatory

The User Agent has been altered by anonymization software.

Unknown

Stringmandatory

We can't extract the device information from the User Agent.

Possible Values of The Operating System Type

Desktop

Stringmandatory

A Desktop OS (Desktop/Laptop)

Mobile

Stringmandatory

A Mobile OS (Tablet/Mobile/Watch)

Game Console

Stringmandatory

Game Console like PlayStation

Embedded

Stringmandatory

An Embedded device (TV, RTOS etc)

Cloud

Stringmandatory

Something running in the cloud environment

Hacker

Stringmandatory

A Hacker

Anonymized

Stringmandatory

Explicitly hidden with some software

Unknown

Stringmandatory

We really don't know about this OS

Possible Values of The Engine Type

Browser

Stringmandatory

Regular Web Browser

Mobile App

Stringmandatory

A mobile app with webview or an app that includes regular browser

Hacker

Stringmandatory

Someone with malicious stuff in useragent string or malformed UA string

Robot

Stringmandatory

A web crawler

Unknown

Stringmandatory

We don't know anything about the identity of this device

Possible Values of The User-Agent Type

Browser

Stringmandatory

Regular Web Browser

Browser Webview

Stringmandatory

Regular browser being used in a mobile app

Mobile App

Stringmandatory

A mobile app accessing the website

Robot Mobile

Stringmandatory

A web crawler who want to be detected as mobile

Cloud Application

Stringmandatory

Something running in the cloud (can be web scrapper etc.)

Email Client

Stringmandatory

An email client

Voice

Stringmandatory

Voice enabled browser that reads out loud

Special

Stringmandatory

Something special we can't classify

Testclient

Stringmandatory

Website testing tool

Hacker

Stringmandatory

Someone with malicious stuff in useragent string or malformed UA string

Unknown

Stringmandatory

We don't know

Quick Links

Quick Links

User Agent Parser API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

Request Headers

API Response Schema

Possible Values of The Device Type

Possible Values of The Operating System Type

Possible Values of The Engine Type

Possible Values of The User-Agent Type

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

User Agent Parser API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

Request Headers

API Response Schema

Possible Values of The Device Type

Possible Values of The Operating System Type

Possible Values of The Engine Type

Possible Values of The User-Agent Type

Docs

Integrations

Pricing & Accounts