Piloterr

Website Antibot

GET
/v2/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

Authentification

ApiKeyAuth
x-api-key<token>

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

In: header

Paramètres de requête

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.

Corps de la réponse

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}