Support > Documentation

API v. 2 - Reference - method "isbot"


 
Send POST request to "http://api.udger.com/isbot" with following parameters.

ParameterDescription
accesskeyYou access key
uaUserAgentString (optional)
ipIP address (v.4 or v.6) - (optional)

Request example:

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

Answer:

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

VariableValueDescription
flag
"0"
"2"
"4"
"6"
"99"
Return code of communication:
OK
ip address is not valid
incorrect acceskey
exceeded the maximum number of queries
BAD REQUEST
errortextstring type valueError descriptoon, for flag "2", "4", "6" and "99" only
is_bot"true"
"false"
This is crawler
This is not crawler (crawler by IP address takes precedence)
bot_by_ua"true"
"false"
This is crawler by UserAgemtString
This is not crawler by UserAgemtString
bot_by_ip"true"
"false"
This is crawler by IP address
This is not crawler by IP address
harmony_ua_ip"true"
"false"
bot_by_ua and bot_by_ip is true
bot_by_ua or bot_by_ip is false
bot_name"null"
"Name"
 
crawler name
bot_udger_url"null"
"URL"
 
URL to udger UA list

Error answer (example):

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

Correct answer (example):

{
	"flag": 0,
	"is_bot": true,
	"bot_by_ua": true,
	"bot_by_ip": true,
	"harmony_ua_ip": true,
	"bot_name": "Googlebot\/2.1",
	"bot_udger_url": "http:\/\/udger.com\/resources\/ua-list\/bot-detail?bot=Googlebot"
}

Among our clients
View more...
 SAP  
 MailChimp  
 Dailymotion SA  
 Akamai Technologies, Inc.  
 Oracle  
 PayPal Holdings, Inc.  
x We have placed cookies on your device to make your experience better. Find more info here.