user-agent-string.info

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).

Parameter	Description
uastrig	string UA konverted by base64
acceskey	string "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):

Variable	Value	Description
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
errortext	string type value	Error descriptoon, useful for flag "4" and "5" only
typ	"crawler" "browser" "offline browser" "user agent anonymizer"	User agent type
ua_name	string type value "unknown"	User agent name or "unknown"
ua_family	string type value "unknown"	User agent family name or "unknown"
ua_url	string type value "unknown"	User agend URL or "unknown"
ua_company	string type value "unknown"	User agent producer or "unknown"
ua_company_url	string type value "unknown"	User agent producer URL or "unknown"
ua_icon	string type value "unknown"	User agent icon URL or "unknown"
os_name	string type value "unknown"	User agent OS name or "unknown"
os_family	string type value "unknown"	User agent OS family name or "unknown"
os_url	string type value "unknown"	User agent OS home URL or "unknown"
os_company	string type value "unknown"	OS producer or "unknown"
os_company_url	string type value "unknown"	OS producer home URL or "unknown"
os_icon	string 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 specification 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.

Parameter	Description
uastrig	string UA konverted by base64
acceskey	string "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):

Variable	Value	Description
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
errortext	string type value	Error descriptoon, useful for flag "4" and "5" only
typ	"crawler" "browser" "offline browser" "user agent anonymizer"	User agent type
ua_name	string type value "unknown"	User agent name or "unknown"
ua_family	string type value "unknown"	User agent family name or "unknown"
ua_url	string type value "unknown"	User agend URL or "unknown"
ua_company	string type value "unknown"	User agent producer or "unknown"
ua_company_url	string type value "unknown"	User agent producer URL or "unknown"
ua_icon	string type value "unknown"	User agent icon URL or "unknown"
os_name	string type value "unknown"	User agent OS name or "unknown"
os_family	string type value "unknown"	User agent OS family name or "unknown"
os_url	string type value "unknown"	User agent OS home URL or "unknown"
os_company	string type value "unknown"	OS producer or "unknown"
os_company_url	string type value "unknown"	OS producer home URL or "unknown"
os_icon	string type value "unknown"	OS icon URL or "unknown"

Error answer (example):

5|system error

Correct answer (example):

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

by ASAP Consulting s.r.o.

- Contact us