Udger Support

https://udger.com/support/documentation
Admin
Udger is a user agent detection service that parses HTTP headers to identify browsers, operating...
Tokens:25,713
Snippets:312
Trust Score:9.8
Update:5 months ago
Show doc for...
Tokens:
Raw
### TXT-RPC Simple Request Example

Source: https://udger.com/support/documentation/?doc=28

Example of a GET request to the old TXT-RPC simple API for user agent parsing. Requires an access key and a base64 encoded user agent string.

```http
http://api.udger.com/old/txtrpcsimple?key=[ACCESS_KEY]&ua=R29vZ2xlYm90LUltYWdlLzEuMA==
```

--------------------------------

### Account API Request Example

Source: https://udger.com/support/documentation/?doc=55

Send a GET or POST request to the v3 account endpoint to retrieve subscription information. Ensure you include your access key.

```http
GET
https://api.udger.com/v3/account?accesskey=XXXXX
```

--------------------------------

### TXT-RPC Request Example

Source: https://udger.com/support/documentation/?doc=23

Example of a GET request to the old TXT-RPC API for user agent parsing. Ensure your access key is included and the user agent string is base64 encoded.

```http
http://api.udger.com/old/txtrpc?key=[ACCESS_KEY]&ua=R29vZ2xlYm90LUltYWdlLzEuMA==
```

--------------------------------

### TXT-RPC Correct Answer Example

Source: https://udger.com/support/documentation/?doc=23

An example of a successful response from the TXT-RPC API, showing the format and types of data returned for a parsed user agent.

```text
1|robot|Googlebot-Image|Googlebot-Image/1.0|http://www.google.com/bot.html| ..... etc. 
```

--------------------------------

### Udger API v3 Parse GET Request Example

Source: https://udger.com/support/documentation/?doc=57

Example of a GET request to the Udger API v3 parse method. Includes parameters for access key, user agent, and IP address.

```http
GET
https://api.udger.com/v3/parse?accesskey=XXXXXX&ua=Mozilla%2F5.0+%28compatible%3B+MSIE+10.0%3B+Windows+NT+6.1%3B+Trident%2F6.0%29&ip=66.249.64.1

```

--------------------------------

### Account API Correct Response Example

Source: https://udger.com/support/documentation/?doc=55

An example of a correct response from the account API, detailing subscription status and query limits for both local and cloud parsers.

```json
{	
	"LocalParser":{
		"subscription":false,
		"subscription_from":null,
		"subscription_to":null
	},
	"CloudParser":{
		"subscription":true,
		"subscription_from":"2016-03-08",
		"subscription_to":"2016-04-08",
		"period":"month",
		"current_period_start":"2016-03-08",
		"max_queries_per_period":"500",
		"currently_queries_per_period":28
	}
}
```

--------------------------------

### Account API Correct Response Example

Source: https://udger.com/support/documentation/?doc=40

This example demonstrates a successful response from the Udger account API, detailing subscription status and query limits.

```json
{
	"flag": 0,
	"LocalParser": {
		"subscription": false,
		"subscription_from": null,
		"subscription_to": null
	},
	"CloudParser": {
		"subscription": true,
		"subscription_from": "2014-12-13",
		"subscription_to": "2015-01-13",
		"period": "month",
		"current_period_start": "2014-12-13",
		"max_queries_per_period": "500",
		"currently_queries_per_period": 5
	}
}
```

--------------------------------

### Udger API Request Example

Source: https://udger.com/support/documentation/?doc=84

This is an example of an HTTP GET request to the Udger API for parsing, including access key and headers.

```http
https://api.udger.com/v4/parse?accesskey=XXXXXX&headers=Sec-Ch-Ua%3A+%22Not%3FA_Brand%22%3Bv%3D%228%22%2C+%22Chromium%22%3Bv%3D%22108%22%2C+%22Google+Chrome%22%3Bv%3D%22108%22%0D%0ASec-Ch-Ua-Mobile%3A+%3F0%0D%0ASec-Ch-Ua-Platform%3A+%22Windows%22%0D%0ASec-Ch-Ua-Platform-Version%3A+%2214.0.0%22&Fip=
```

--------------------------------

### Cloud Parser v4 Parse Example (PHP)

Source: https://udger.com/support/documentation/?doc=77

Example of how to use the Cloud parser v4 with PHP to parse a URL, including headers and IP address. Requires an access key.

```php
$accesskey = "XXXXXX"; // Your access key
$url = "https://api.udger.com/v4/parse";
$headers = "Sec-Ch-Ua: \"Chromium\";v=\"104\", \" Not A;Brand\";v=\"99\", \"Google Chrome\";v=\"104\"
Sec-Ch-Ua-Mobile: ?0
Sec-Ch-Ua-Full-Version: \"104.0.5112.102\"
Sec-Ch-Ua-Arch: \"x86\"
Sec-Ch-Ua-Platform: \"Windows\"
Sec-Ch-Ua-Platform-Version: \"14.0.0\"
Sec-Ch-Ua-Model: \"\"
Sec-Ch-Ua-Bitness: \"64\"
Sec-Ch-Ua-Full-Version-List: \"Chromium\";v=104.0.5112.102, \" Not A;Brand\";v=\"99.0.0.0\", \"Google Chrome\";v=\"104.0.5112.102\"
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36";
$ip = "66.249.64.1";
$res = file_get_contents($url . "?accesskey=" . $accesskey . "&headers=" . urlencode($headers) . "&ip=" . urlencode($ip));
$js = json_decode($res,true);
print_r($js);
```

--------------------------------

### PHP Cloud Parser 'parse' Example

Source: https://udger.com/support/documentation/?doc=26

Example of using the Udger cloud parser with PHP to analyze a user agent string. This snippet demonstrates a basic API call for parsing.

```PHP
<?php

// Example of using the Udger cloud parser with PHP
// Replace with your actual API key and user agent string

$apiKey = 'YOUR_API_KEY';
$userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api.udger.com/v3/parse/json?apikey=' . $apiKey . '&agent=' . urlencode($userAgent));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    // Process the parsed data
    print_r($data);
}

curl_close($ch);

?>
```

--------------------------------

### XML Response Example

Source: https://udger.com/support/documentation/?doc=9

This XML structure represents a correct method response from Udger, detailing information about a detected robot.

```xml
<?xml version="1.0"?>
<methodResponse>
 <params>
   <param>
   <value>
   <struct>
   <member>
    <name>flag</name>
    <value><int>1</int></value>
   </member>
   <member>
    <name>typ</name>
    <value><string>robot</string></value>
   </member>
   <member>
    <name>ua_family</name>
    <value><string>Googlebot-Image</string></value>
   </member>
   <member>
    <name>ua_name</name>
    <value><string>Googlebot-Image/1.0</string></value>
   </member>
   <member>
    <name>ua_url</name>
    <value><string>http://www.google.com/bot.html</string></value>
   </member>
   <member>
    <name>ua_company</name>
    <value><string>Google Inc.</string></value>
   </member>
   <member>
    <name>ua_company_url</name>
    <value><string>http://www.google.com/</string></value>
   </member>
   <member>
    <name>ua_icon</name>
    <value><string>http://ua.loc/img/ua/bot.png</string></value>
   </member>
   <member>
    <name>os_family</name>
    <value><string>unknown</string></value>
   </member>
   <member>
    <name>os_name</name>
    <value><string>unknown</string></value>
   </member>
   <member>
    <name>os_url</name>
   <value>
    <string>unknown</string></value>
   </member>
   <member>
    <name>os_company</name>
    <value><string>unknown</string></value>
   </member>
   <member>
    <name>os_company_url</name>
    <value><string>unknown</string></value>
   </member>
   <member><name>os_icon</name>
   <value><string>http://ua.loc/img/os/unknown.png</string></value>
   </member>
   </struct>
   </value>
 </param>
</params>
</methodResponse>
```

--------------------------------

### TXT-RPC Error Answer Example

Source: https://udger.com/support/documentation/?doc=23

An example of an error response from the TXT-RPC API, illustrating the format for system errors or incorrect access keys.

```text
5|system error
```

--------------------------------

### Udger Cloud Parser API v3 Parse Example (PHP)

Source: https://udger.com/support/documentation/?doc=58

This example demonstrates how to use the Udger Cloud Parser API v3 in PHP to analyze a user agent string and/or IP address. It requires input for both fields.

```PHP
<?php

// Example for Cloud parser: udger.com API v3

// User agent string (optional)
$user_agent_string = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36";

// IP address (optional, IPv4 or IPv6)
$ip_address = "8.8.8.8";

// Construct the API URL (replace with your actual API key and desired endpoint)
$api_url = "https://api.udger.com/v3/parse?token=YOUR_API_TOKEN&ua=" . urlencode($user_agent_string) . "&ip=" . urlencode($ip_address);

// Initialize cURL session
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);

// Execute cURL session
$response = curl_exec($ch);

// Check for errors
if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // Process the response (JSON)
    $data = json_decode($response, true);
    
    // Output the parsed data (example)
    if (isset($data['ua']['browser']['name'])) {
        echo "Browser: " . $data['ua']['browser']['name'] . "\n";
    }
    if (isset($data['ip']['country']['name'])) {
        echo "Country: " . $data['ip']['country']['name'] . "\n";
    }
    // Print the full response for debugging
    // print_r($data);
}

// Close cURL session
curl_close($ch);

?>

```

--------------------------------

### API v4 Parse Request Example

Source: https://udger.com/support/documentation/?doc=84

Example of a GET request to the Udger API v4 parse endpoint. Include your access key and optionally headers or IP address.

```http
GET
https://api.udger.com/v4/parse?accesskey=XXXXXX&headers=Sec-Ch-Ua%3A+%22Not%3FA_Brand%22%3Bv%3D%228%22%2C+%22Chromium ...

```

--------------------------------

### Account API Error Response Example

Source: https://udger.com/support/documentation/?doc=55

An example of an error response from the account API, indicating unauthorized access.

```json
{
	"error":401,
	"errortext":"UNAUTHORIZED"
}
```

--------------------------------

### Udger API v3 'account' Example (PHP)

Source: https://udger.com/support/documentation/?doc=56

This snippet demonstrates how to use the Udger API v3 for account-related operations using PHP. It requires an access key for authentication.

```PHP
<?php

// Example for udger.com API v3 'account' (PHP)

// Replace with your actual access key
$access_key = 'YOUR_ACCESS_KEY';

// API endpoint for account information
$api_url = 'https://api.udger.com/v3/account';

// Initialize cURL session
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['access_key' => $access_key]));

// Execute cURL session
$response = curl_exec($ch);

// Check for errors
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
} else {
    // Process the response (e.g., decode JSON)
    $data = json_decode($response, true);
    if ($data) {
        print_r($data);
    } else {
        echo 'Failed to decode JSON response.';
    }
}

// Close cURL session
curl_close($ch);

?>
```

--------------------------------

### Udger Parser Response Example

Source: https://udger.com/support/documentation/?doc=38

This JSON object represents a typical response from the Udger parser, detailing browser, OS, and device information.

```json
{
	"flag": 0,
	"info": {
		"type": "Browser",
		"ua_name": "Chrome 39.0.2171.95",
		"ua_ver": "39.0.2171.95",
		"ua_family": "Chrome",
		"ua_url": "http:\/\/www.google.com\/chrome",
		"ua_company": "Google Inc.",
		"ua_company_url": "http:\/\/www.google.com\/",
		"ua_icon": "http:\/\/udger.com\/pub\/img\/ua\/chrome.png",
		"ua_engine": "WebKit\/Blink",
		"ua_udger_url": "http:\/\/udger.com\/resources\/ua-list\/browser-detail?browser=Chrome",
		"os_name": "Windows 7",
		"os_family": "Windows",
		"os_url": "http:\/\/en.wikipedia.org\/wiki\/Windows_7",
		"os_company": "Microsoft Corporation.",
		"os_company_url": "http:\/\/www.microsoft.com\/",
		"os_icon": "http:\/\/udger.com\/pub\/img\/os\/windows-7.png",
		"os_udger_url": "http:\/\/udger.com\/resources\/ua-list\/os-detail?os=Windows",
		"device_name": "Personal computer",
		"device_icon": "http:\/\/udger.com\/pub\/img\/device\/desktop.png",
		"device_udger_url": "http:\/\/udger.com\/resources\/ua-list\/device-detail?device=Personal computer"
	},
	"fragments": {
		"Mozilla\/5.0": "They claim that it is based on Mozilla user agent (only true for Gecko browsers). It is now used only for historical reasons.",
		"Windows NT 6.1": "OS signature",
		"WOW64": "Windows running on a 64-bit processor signature",
		"AppleWebKit\/537.36": " Open source application framework</a> ver. 537.36",
		"(KHTML, like Gecko)": "HTML layout engine developed by the KDE project</a>",
		"Chrome\/39.0.2171.95": "browser signature",
		"Safari\/537.36": "browser signature"
	},
	"uptodate": {
		"controlled": true,
		"is": true,
		"ver": "39",
		"url": "http:\/\/www.google.com\/chrome"
	}
}

```

--------------------------------

### Parse User Agent and IP in Perl

Source: https://udger.com/support/documentation/?doc=54

This example demonstrates how to use the LWP::UserAgent module in Perl to send a POST request to the Udger API. It sets up the necessary parameters and prints the response.

```perl
use LWP::UserAgent;
my $ACCESSKEY = "XXXXXX"; # Your access key
my $UA = "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)";
my $IP = "66.249.64.1";
# Crete an UserAgent
my $ua = LWP::UserAgent->new();
# set POST variables
my %form;
$form{'accesskey'}=$ACCESSKEY;
$form{'ua'}=$UA;
$form{'ua'}=$IP;
# Create a request
my $response = $ua->post( "http://api.udger.com/v3/parse", \%form );
# get a response back
my $content = $response->as_string();
print $content;
```

--------------------------------

### Example JSON Response from Udger Parser

Source: https://udger.com/support/documentation/?doc=84

This JSON object represents a typical response from the Udger parser, detailing user agent and IP address information.

```json
{
   "user_agent": {
        "ua_string": "",
        "sec_ch_ua": "Not?A_Brand\";v=\"8\", \"Chromium\";v=\"108\", \"Google Chrome\";v=\"108",
        "sec_ch_ua_full_version_list": "",
        "sec_ch_ua_mobile": "0",
        "sec_ch_ua_full_version": "",
        "sec_ch_ua_platform": "Windows",
        "sec_ch_ua_platform_version": "14.0.0",
        "sec_ch_ua_model": "",
        "ua_class": "Browser",
        "ua_class_code": "browser",
        "ua": "Chrome 108",
        "ua_version": "108",
        "ua_version_major": "108",
        "ua_uptodate_current_version": "108",
        "ua_family": "Chrome",
        "ua_family_code": "chrome",
        "ua_family_homepage": "http://www.google.com/chrome/",
        "ua_family_vendor": "Google Inc.",
        "ua_family_vendor_code": "google_inc",
        "ua_family_vendor_homepage": "https://about.google/",
        "ua_family_icon": "chrome.png",
        "ua_family_icon_big": "chrome_big.png",
        "ua_family_info_url": "https://udger.com/resources/ua-list/browser-detail?browser=Chrome",
        "ua_engine": "WebKit/Blink",
        "os": "Windows 11",
        "os_code": "windows_11",
        "os_homepage": "https://en.wikipedia.org/wiki/Windows_11",
        "os_icon": "win11.png",
        "os_icon_big": "win11_big.png",
        "os_info_url": "https://udger.com/resources/ua-list/os-detail?os=Windows 11",
        "os_family": "Windows",
        "os_family_code": "windows",
        "os_family_vendor": "Microsoft Corporation.",
        "os_family_vendor_code": "microsoft_corporation",
        "os_family_vendor_homepage": "https://www.microsoft.com/about/",
        "device_class": "Desktop",
        "device_class_code": "desktop",
        "device_class_icon": "desktop.png",
        "device_class_icon_big": "desktop_big.png",
        "device_class_info_url": "https://udger.com/resources/ua-list/device-detail?device=Desktop",
        "device_marketname": "",
        "device_vendor": "",
        "device_vendor_code": "",
        "device_vendor_homepage": "",
        "device_vendor_icon": "",
        "crawler_last_seen": "",
        "crawler_category": "",
        "crawler_category_code": "",
        "crawler_respect_robotstxt": ""
    },
    "ip_address": {
        "ip": "",
        "ip_ver": "",
        "ip_classification": "",
        "ip_classification_code": "",
        "ip_hostname": "",
        "ip_last_seen": "",
        "ip_country": "",
        "ip_country_code": "",
        "ip_city": "",
        "crawler_name": "",
        "crawler_ver": "",
        "crawler_ver_major": "",
        "crawler_family": "",
        "crawler_family_code": "",
        "crawler_family_homepage": "",
        "crawler_family_vendor": "",
        "crawler_family_vendor_code": "",
        "crawler_family_vendor_homepage": "",
        "crawler_family_icon": "",
        "crawler_family_info_url": "",
        "crawler_last_seen": "",
        "crawler_category": "",
        "crawler_category_code": "",
        "crawler_respect_robotstxt": "",
        "datacenter_name": "",
        "datacenter_name_code": "",
        "datacenter_homepage": ""
    }
}

```

--------------------------------

### Parse User Agent in Python

Source: https://udger.com/support/documentation/?doc=25

This Python example utilizes `urllib` to construct and send a POST request to the Udger API, then parses the JSON response.

```python
import json
import pprint
try:
    from urllib.parse import urlencode
    from urllib.request import urlopen
except ImportError:
    from urllib import urlencode, urlopen  # Python 2

post_data = {
    'accesskey': 'XXXXXX',
    'ua': 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)',
}

response_bytes = urlopen(
    'http://api.udger.com/parse',
    urlencode(post_data).encode('UTF-8'),
).read()
data_dict = json.loads(
    response_bytes.decode('UTF-8'),
)
pprint.pprint(data_dict)
```

--------------------------------

### XML-RPC Request Example for UA Search

Source: https://udger.com/support/documentation/?doc=9

This snippet shows how to send a POST request to the old XML-RPC API for user agent searching. It includes the method name and parameters for the UA string and access key.

```xml
<?xml version="1.0"?>
<methodCall>
 <methodName>ua.search</methodName>
 <params>
  <param>
   <value><string>R29vZ2xlYm90LUltYWdlLzEuMA==</string></value>
  </param>
  <param>
  <value><string>[ACCESS_KEY]</string></value>
  </param>
 </params>
</methodCall>
```

--------------------------------

### Udger.com API v4 Parse Example (PHP)

Source: https://udger.com/support/documentation/?doc=78

This snippet demonstrates how to use the Udger.com API v4 for parsing with PHP. It shows how to send HTTP headers and IP addresses for analysis.

```php
<?php

// Example usage of Udger.com API v4 parse function in PHP

// Replace with your actual API key
$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://api.udger.com/v4/parse';

// Example headers and IP address
$headers = [
    'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
    'Sec-Ch-Ua: " Not A;Brand";v="99", "Chromium";v="91", "Google Chrome";v="91"',
    'Sec-Ch-Ua-Mobile: ?0',
    'Sec-Ch-Ua-Platform: "Windows"'
];
$ipAddress = '8.8.8.8';

// Prepare the data for the API request
$data = [
    'ip' => $ipAddress,
    'headers' => implode("\n", $headers) // Combine headers into a single string
];

// Initialize cURL session
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'X-Api-Key: ' . $apiKey
]);

// Execute cURL session
$response = curl_exec($ch);

// Check for errors
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    // Process the response
    $result = json_decode($response, true);
    
    // Output the result (or handle it as needed)
    print_r($result);
}

// Close cURL session
curl_close($ch);

?>

```

--------------------------------

### Account API POST Request Example

Source: https://udger.com/support/documentation/?doc=40

This snippet shows how to send a POST request to the Udger account API. Ensure you replace 'XXXXXX' with your actual access key.

```http
POST
accesskey=XXXXXX
to
http://api.udger.com/account
```

--------------------------------

### API v.2 - Parse Method Request Example

Source: https://udger.com/support/documentation/?doc=38

Send a POST request to the Udger parse endpoint with your access key and user agent string. Ensure your access key is valid and you have not exceeded query limits.

```http
POST
accesskey=XXXXXX&Googlebot-Image%2F1.0
to
http://api.udger.com/parse
```

--------------------------------

### isbot Method POST Request Example

Source: https://udger.com/support/documentation/?doc=39

This snippet shows how to construct a POST request to the Udger API's 'isbot' endpoint. It includes the required access key and optional UserAgent and IP address parameters.

```http
POST
accesskey=XXXXXX&ua=Mozilla%2F5.0+%28compatible%3B+Googlebot%2F2.1%3B+%2Bhttp%3A%2F%2Fwww.google.com%2Fbot.html%29&ip=66.249.64.1
to
http://api.udger.com/isbot
```

--------------------------------

### User Agent and IP Address Parsing Example

Source: https://udger.com/support/documentation/?doc=57

This JSON object demonstrates the detailed information returned by Udger for a given user agent string and IP address. It includes classifications for the user agent, operating system, device, and IP address, along with specific details about crawlers.

```json
{
   "user_agent":{
      "ua_string":"Mozilla\/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident\/6.0)",
      "ua_class":"Browser",
      "ua_class_code":"browser",
      "ua":"IE 10.0",
      "ua_version":"10.0",
      "ua_version_major":"10",
      "ua_uptodate_current_version":"11",
      "ua_family":"IE",
      "ua_family_code":"ie",
      "ua_family_homepage":"https:\/\/en.wikipedia.org\/wiki\/Internet_Explorer",
      "ua_family_vendor":"Microsoft Corporation.",
      "ua_family_vendor_code":"microsoft_corporation",
      "ua_family_vendor_homepage":"https:\/\/www.microsoft.com\/about\/",
      "ua_family_icon":"msie.png",
      "ua_family_icon_big":"msie_big.png",
      "ua_family_info_url":"https:\/\/udger.com\/resources\/ua-list\/browser-detail?browser=IE",
      "ua_engine":"Trident",
      "os":"Windows 7",
      "os_code":"windows_7",
      "os_homepage":"https:\/\/en.wikipedia.org\/wiki\/Windows_7",
      "os_icon":"windows-7.png",
      "os_icon_big":"windows-7_big.png",
      "os_info_url":"https:\/\/udger.com\/resources\/ua-list\/os-detail?os=Windows 7",
      "os_family":"Windows",
      "os_family_code":"windows",
      "os_family_vendor":"Microsoft Corporation.",
      "os_family_vendor_code":"microsoft_corporation",
      "os_family_vendor_homepage":"https:\/\/www.microsoft.com\/about\/",
      "device_class":"Desktop",
      "device_class_code":"desktop",
      "device_class_icon":"desktop.png",
      "device_class_icon_big":"desktop_big.png",
      "device_class_info_url":"https:\/\/udger.com\/resources\/ua-list\/device-detail?device=Desktop",
      "device_brand": "",
      "device_brand_code": "",
      "device_brand_homepage": "",
      "device_brand_icon": "",
      "device_brand_icon_big": "",
      "device_brand_info_url": "",
      "crawler_last_seen":"",
      "crawler_category":"",
      "crawler_category_code":"",
      "crawler_respect_robotstxt":""
   },
   "ip_address":{
      "ip":"66.249.64.1",
      "ip_ver":4,
      "ip_classification":"Crawler",
      "ip_classification_code":"crawler",
      "ip_hostname":"crawl-66-249-64-1.googlebot.com",
      "ip_last_seen":"2016-01-12 08:31:41",
      "ip_country":"United States",
      "ip_country_code":"US",
      "ip_city":"Mountain View",
      "crawler_name":"Googlebot\/2.1",
      "crawler_ver":"2.1",
      "crawler_ver_major":"2",
      "crawler_family":"Googlebot",
      "crawler_family_code":"googlebot",
      "crawler_family_homepage":"http:\/\/www.google.com\/bot.html",
      "crawler_family_vendor":"Google Inc.",
      "crawler_family_vendor_code":"google_inc",
      "crawler_family_vendor_homepage":"https:\/\/www.google.com\/about\/company\/",
      "crawler_family_icon":"bot_googlebot.png",
      "crawler_family_info_url":"https:\/\/udger.com\/resources\/ua-list\/bot-detail?bot=Googlebot",
      "crawler_last_seen":"2016-03-14 07:40:11",
      "crawler_category":"Search engine bot",
      "crawler_category_code":"search_engine_bot",
      "crawler_respect_robotstxt":"yes",
      "datacenter_name":"",
      "datacenter_name_code":"",
      "datacenter_homepage":""
   }
}
```

--------------------------------

### Udger API v3 Error Response Example

Source: https://udger.com/support/documentation/?doc=57

Example of an error response from the Udger API v3. Shows the structure for error codes and messages.

```json
{
	"error":400,
	"errortext":"BAD REQUEST"
}

```

--------------------------------

### isbot Method Error Response Example

Source: https://udger.com/support/documentation/?doc=39

This example demonstrates the JSON structure for an error response from the 'isbot' API method. It includes a 'flag' indicating the error type and an 'errortext' for a description.

```json
{
	"flag": 4,
	"errortext": "incorrect acceskey"
}
```

--------------------------------

### Parse User Agent and IP in Python

Source: https://udger.com/support/documentation/?doc=54

This Python example uses the `urllib` module to make a POST request to the Udger API. It handles potential import differences between Python 2 and Python 3 and prints the parsed JSON data.

```python
import json
import pprint
try:
    from urllib.parse import urlencode
    from urllib.request import urlopen
except ImportError:
    from urllib import urlencode, urlopen  # Python 2
post_data ={
    'accesskey': 'XXXXXX',
    'ua': 'Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0)',
    'ip': '66.249.64.1',
}
try:
    response_bytes = urlopen(
            'https://api.udger.com/v3/parse',
            urlencode(post_data).encode('UTF-8'),
    ).read()
    data_dict = json.loads(
            response_bytes.decode('UTF-8'),
    )
except Exception as e:
    print("Udger.com request failed:", e)
else:
    pprint.pprint(data_dict)
```

--------------------------------

### API v. 3 - Reference - method "parse"

Source: https://udger.com/support/documentation/?doc=57

Send GET or POST request to "https://api.udger.com/v3/parse" with following parameters to get information about useragent and/or IP address.

```APIDOC
## API v. 3 - Reference - method "parse"

### Description
Provides information about useragent and/or IP address.

### Method
GET or POST

### Endpoint
https://api.udger.com/v3/parse

### Parameters
#### Query Parameters
- **accesskey** (string) - Yes - Your access key
- **ua** (string) - No - URL-encoded useragent string
- **ip** (string) - No - URL-encoded IP address v4 or v6

### Request Example
```
GET
https://api.udger.com/v3/parse?accesskey=XXXXXX&ua=Mozilla%2F5.0+%28compatible%3B+MSIE+10.0%3B+Windows+NT+6.1%3B+Trident%2F6.0%29&ip=66.249.64.1
```

### Response
#### Success Response (200)
(No specific success response schema provided in source)

#### Response Example
(No specific success response example provided in source)

### Error Handling
#### Error Response Example
```json
{
	"error":400,
	"errortext":"BAD REQUEST"
}
```
```

--------------------------------

### TXT-RPC old API

Source: https://udger.com/support/documentation/?doc=23

This section details how to use the TXT-RPC old API to get information about a user agent string. It involves sending a GET request to a specific endpoint with parameters like the user agent string and an access key.

```APIDOC
## TXT-RPC old (user-agent-string.info)

### Description
Send GET request to _http:/api.udger.com/old/txtrpc_ with following parameters to retrieve information about a user agent string.

### Method
GET

### Endpoint
http://api.udger.com/old/txtrpc

### Parameters
#### Query Parameters
- **uastrig** (string) - Required - UA converted by base64
- **key** (string) - Required - private accesskey string

### Request Example
For UA "Googlebot-Image/1.0" sent by method GET:
`http://api.udger.com/old/txtrpc?key=[ACCESS_KEY]&ua=R29vZ2xlYm90LUltYWdlLzEuMA==`

### Response
#### Success Response
Answer format includes selection of following values (encoded in UTF-8):
- **flag** (integer) - Return code of communication: OK, unknown OS, unknown UA, unknown OS and UA, incorrect acceskey, System error
- **errortext** (string) - Error description, useful for flag "4" and "5" only
- **type** (string) - User agent type: "robot", "browser", "mobile browser", "email client", "wap browser", "offline browser", "ua anonymizer", "library", "other"
- **ua_name** (string) - User agent name or "unknown"
- **ua_family** (string) - User agent family name or "unknown"
- **ua_url** (string) - User agent URL or "unknown"
- **ua_company** (string) - User agent producer or "unknown"
- **ua_company_url** (string) - User agent producer URL or "unknown"
- **ua_icon** (string) - User agent icon URL or "unknown"
- **os_name** (string) - User agent OS name or "unknown"
- **os_family** (string) - User agent OS family name or "unknown"
- **os_url** (string) - User agent OS home URL or "unknown"
- **os_company** (string) - OS producer or "unknown"
- **os_company_url** (string) - OS producer home URL or "unknown"
- **os_icon** (string) - OS icon URL or "unknown"

#### Response Example
Correct answer (example):
`1|robot|Googlebot-Image|Googlebot-Image/1.0|http://www.google.com/bot.html| ..... etc. `
```
Tokens:
Raw