On this page

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.

Get started

This API is part of the IP Geolocation package and is available in free and paid plans. Please visit the IP Geolocation package page for limits and pricing information.

Endpoint

GET
https://api.bigdatacloud.net/data/user-agent-info

Request

Parameter
Type
Required
Description
Parameter
userAgentRaw
Type
string
Required
Yes
Description
User agent string input
Parameter
key
Type
string
Required
Yes
Description
Your API key

Responses

Example query

https://api.bigdatacloud.net/data/user-agent-info?userAgentRaw=Mozilla/5.0 (iPhone; CPU iPhone OS 7_0 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) Version/7.0 Mobile/11A465 Safari/9537.53 (compatible; bingbot/2.0; http://www.bing.com/bingbot.htm)&key=[YOUR API KEY]
  

Example response

  • 1
    {
  • 2
    "device": "Spider",
  • 3
    "os": "iOS 7.0",
  • 4
    "userAgent": "bingbot 2.0",
  • 5
    "family": "bingbot",
  • 6
    "versionMajor": "2",
  • 7
    "versionMinor": "0",
  • 8
    "isSpider": true,
  • 9
    "isMobile": false,
  • 10
    "userAgentDisplay": "iOS 7.0 Spider bingbot 2.0"
  • 11
    }

Schema

application/json