User Agent Parser API

Introduction

By default, an internet browser provides a User-Agent string (UA) which carries detailed device and browser information (type, version, OS etc).

However, different browsers provide the UA strings in different formats, making it difficult to interpret this information directly. This could require hours of coding and testing a parser that effectively reads all the variations.

This User-Agent Parser API solves this problem by providing an extremely quick and simple parser which can provide clearly readable and defined information based on the provided UA string.

UA string is commonly used in web analytics tools to monitor and identify access to your website by device type. This can provide useful insights such as the proportion of your traffic that comes from mobile devices and the level of need to create a responsive web design and deliver mobile-optimised content.

Example Response

The response is only available in JSON format. The below response should be expected for the following request:



Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
userAgentRaw User agent string
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.



Response

Awaiting request submission...

Response Format

Field

Data type

Description

device

string

The Device parsed from the user agent string

os

string

The OS parsed from the user agent string

userAgent

string

The User-Agent parsed from the user agent string

family

string

The family of the device, if available

versionMajor

string

The major version of the user agent, if available

versionMinor

string

The minor version of the user agent, if available

versionPatch

string

Patch version of the user agent, if available

isSpider

boolean

Returns true if the device is likely to be a spider or a bot device

isMobile

boolean

Returns true if the device is likely to be of a mobile type

userAgentDisplay

string

The user agent as a readable string

userAgentRaw

string

The user agent string, the input for the UA parser

Related APIs