Piloterr

Website Antibot

Detect which anti-bot protection protects a website before you scrape. Get the vendor, confidence level, and matching clues from a single URL check.

Credit cost: 1 credit per call

GET
/v2/website/antibot

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full URL or domain name to analyze for anti-bot protection. Must be a valid hostname.

Examples:

https://www.example.com
example.com

Notes:

  • Passive fingerprinting from HTTP headers, cookies, and page content.
  • Challenge pages (403, 503) still count as a successful analysis.
timeout?number

Maximum request timeout in seconds. Defaults to 15.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/website/antibot?query=string"

{
  "status": 200,
  "vendor": "cloudflare",
  "final_url": "https://www.crunchbase.com/",
  "confidence": "high",
  "detections": [
    {
      "vendor": "cloudflare",
      "evidence": [
        "Header cf-ray: a1da70864ed39e6f-CDG",
        "Header cf-cache-status: HIT",
        "Header server: cloudflare",
        "Cookie __cf_bm present (Bot Management)"
      ],
      "confidence": "high"
    }
  ],
  "requested_url": "https://www.crunchbase.com/"
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}