user-agent-string.info API

User-agent-string.info API is designed for hands off access to database with informations about user agent. Using is simple, send UA string to our server and get automatic response by using metod.

API is temporarily free and some type of API (restricted by number of requsets per hour) stand for free.

API is accessible by following metods: XML-RPC or TXT-RPC
 


XML-RPC

User-agent-string.info XML-RPC - using description:

Send POST request to http://user-agent-string.info/rpc/rpcxml.php with following parameters. (here is one metod permited only - ua.search).

ParameterDescription
uastrigstring UA konverted by base64
acceskeystring "free" nebo private key string

Request example for UA "Googlebot-Image/1.0" sended by metod POST

<?xml version="1.0"?> <methodCall> <methodName>ua.search</methodName> <params> <param> <value><string>R29vZ2xlYm90LUltYWdlLzEuMA==</string></value> </param> <param> <value><string>free</string></value> </param> </params> </methodCall>

Answer:

Answer format includes selection of following values (encoded in UTF-8):

VariableValueDescription
flag
"0"
"1"
"2"
"3"
"4"
"5"
Návratový kód komunikace:
OK
neznámý OS
neznámy UA
neznámý OS i UA
chybný, nebo nesprávný klíč
systémová chyba
errortextstring type valueError descriptoon, useful for flag "4" and "5" only
typ"crawler"
"browser"
"offline browser"
"user agent anonymizer"
User agent type
ua_namestring type value
"unknown"
User agent name or "unknown"
ua_familystring type value
"unknown"
User agent family name or "unknown"
ua_urlstring type value
"unknown"
User agend URL or "unknown"
ua_companystring type value
"unknown"
User agent producer or "unknown"
ua_company_urlstring type value
"unknown"
User agent producer URL or "unknown"
ua_iconstring type value
"unknown"
User agent icon URL or "unknown"
os_namestring type value
"unknown"
User agent OS name or "unknown"
os_familystring type value
"unknown"
User agent OS family name or "unknown"
os_urlstring type value
"unknown"
User agent OS home URL or "unknown"
os_companystring type value
"unknown"
OS producer or "unknown"
os_company_urlstring type value
"unknown"
OS producer home URL or "unknown"
os_iconstring type value
"unknown"
OS icon URL or "unknown"

Error answer (example):

<?xml version="1.0"?> <methodResponse> <params> <param> <value> <struct> <member> <name>flag</name> <value><int>5</int></value> </member> <member> <name>errortext</name> <value><string>system error</string></value> </member> </struct> </value> </param> </params> </methodResponse>

Correct answer (example):

<?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>

PHP example, open code and XML-RPC specificationExternal are here for interested persons.

TXT-RPC

User-agent-string.info TXT-RPC - using description:

Send GET request to http://user-agent-string.info/rpc/rpctxt.php with following parameters.

ParameterDescription
uastrigstring UA konverted by base64
acceskeystring "free" or private key string

Request example for UA "Googlebot-Image/1.0" sended by metod GET:

http://ua.loc/rpc/rpctxt.php?key=free&ua=R29vZ2xlYm90LUltYWdlLzEuMA==

Answer:

Answer format includes selection of following values (encoded in UTF-8):

VariableValueDescription
flag
"0"
"1"
"2"
"3"
"4"
"5"
Návratový kód komunikace:
OK
neznámý OS
neznámy UA
neznámý OS i UA
chybný, nebo nesprávný klíč
systémová chyba
errortextstring type valueError descriptoon, useful for flag "4" and "5" only
typ"crawler"
"browser"
"offline browser"
"user agent anonymizer"
User agent type
ua_namestring type value
"unknown"
User agent name or "unknown"
ua_familystring type value
"unknown"
User agent family name or "unknown"
ua_urlstring type value
"unknown"
User agend URL or "unknown"
ua_companystring type value
"unknown"
User agent producer or "unknown"
ua_company_urlstring type value
"unknown"
User agent producer URL or "unknown"
ua_iconstring type value
"unknown"
User agent icon URL or "unknown"
os_namestring type value
"unknown"
User agent OS name or "unknown"
os_familystring type value
"unknown"
User agent OS family name or "unknown"
os_urlstring type value
"unknown"
User agent OS home URL or "unknown"
os_companystring type value
"unknown"
OS producer or "unknown"
os_company_urlstring type value
"unknown"
OS producer home URL or "unknown"
os_iconstring type value
"unknown"
OS icon URL or "unknown"

Error answer (example):

5|system error

Correct answer (example):

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

PHP example and open code are here again for interested persons.


 
by ASAP Consulting s.r.o. External - Contact us