Fraud detection API
The KillBot service creates a cookie "kb" for the website via the verification page [or without it]. After getting verified, you should send a request to get the results of the fraud check.
API interaction goes through a standard server https://api.kill-bot.net, or we can allocate a custom server and a domain.
API interaction goes through a standard server https://api.kill-bot.net, or we can allocate a custom server and a domain.
1
Add the verification page to the website or contact us directly if you want to apply integration without it.
2.1
Get the results of the fraud check
/get
/get
Example: https://api.kill-bot.net/get?APIkey={APIkey}&kb={kb}
Description:
APIkey - your API key (contact us to get it)
kb - session cookie "kb"
Description:
APIkey - your API key (contact us to get it)
kb - session cookie "kb"
Response in JSON format:
{
bot: Unknown,
fraud: true,
hash: 1569215450,
loaded: true,
session: 534389081,
ua: Chrome Mobile,
action: 0
}error: It indicates that something is wrong. "Error" prevents other parameters from being sent.
error_string: A row with an error description. It appears only when an error occurs.
bot: A bot's name. The parameter appears when a bot is detected. It shows the bot's name if there is information on it in our database, or "Unknown" if there is no data.
fraud: The results of the check fraud. If it is "false" then a transition to the website is made via a browser. The result ''true" means there is a bot.
hash: The hash of a browser or any device a bot uses. Chrome, Safari, a bot made with Node.js, or any other software has its own hash that differs from others.
loaded: It indicates whether the verification page is loaded completely. "True" means the verification page is loaded completely. "False" means the verification page is not loaded completely. NOTICE! If the verification page is not loaded completely: loaded = false, then hash = 0 and fraud = true.
session: The definition of the parameter "kb_session".
ua: The User-Agent derived from the browser parameter "useragent".
action: Recommended action: 0 - work normally, 1 - work in reading mode, 2 - block.
error_string: A row with an error description. It appears only when an error occurs.
bot: A bot's name. The parameter appears when a bot is detected. It shows the bot's name if there is information on it in our database, or "Unknown" if there is no data.
fraud: The results of the check fraud. If it is "false" then a transition to the website is made via a browser. The result ''true" means there is a bot.
hash: The hash of a browser or any device a bot uses. Chrome, Safari, a bot made with Node.js, or any other software has its own hash that differs from others.
loaded: It indicates whether the verification page is loaded completely. "True" means the verification page is loaded completely. "False" means the verification page is not loaded completely. NOTICE! If the verification page is not loaded completely: loaded = false, then hash = 0 and fraud = true.
session: The definition of the parameter "kb_session".
ua: The User-Agent derived from the browser parameter "useragent".
action: Recommended action: 0 - work normally, 1 - work in reading mode, 2 - block.
2.2
Add a bot to the blacklist or whitelist
/add
/add
Example:
https://api.kill-bot.net/add?APIkey={APIkey}&hash={hash}&fraud=true
Description:
APIkey - your API key (contact us to get it)
hash - browser hash received by /get method
fraud - mark all visits with this hash as fraud or vice versa
https://api.kill-bot.net/add?APIkey={APIkey}&hash={hash}&fraud=true
Description:
APIkey - your API key (contact us to get it)
hash - browser hash received by /get method
fraud - mark all visits with this hash as fraud or vice versa
Response in JSON format:
{
result: 0,
error: 0,
error_string: "",
}result: If the result = 0 there is no error.
error: It indicates that something is wrong. "Error" prevents other parameters from being sent.
error_string: A row with an error description. It appears only when an error occurs.
error: It indicates that something is wrong. "Error" prevents other parameters from being sent.
error_string: A row with an error description. It appears only when an error occurs.