Blockbot API Documentation

Blockbot provides a simple HTTP API to detect IP abuse and automated traffic.

Authentication

https://domain/lookup?token=YOUR_API_TOKEN&query=IP

Endpoint

GET /lookup

Example (PHP)

$data = json_decode(
  file_get_contents("https://domain/lookup?token=xxx&query=1.1.1.1"),
  true
);
if ($data['blocked']) die("Blocked");
      

Error Codes

{ "error": "INVALID_TOKEN" }

Risk Policy

• 0.0 – 0.3 → Allow
• 0.4 – 0.6 → Monitor
• 0.7+ → Block