Website Antibot
GET
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
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull URL or domain name to analyze for anti-bot protection. Must be a valid hostname.
Examples:
https://www.example.comexample.comNotes:
- Passive fingerprinting from HTTP headers, cookies, and page content.
- Challenge pages (403, 503) still count as a successful analysis.
timeout?numberMaximum request timeout in seconds. Defaults to 15.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
status?integervendor?stringfinal_url?stringconfidence?stringdetections?array<>requested_url?stringcurl -X GET 'https://api.piloterr.com/v2/website/antibot?query=string'Example Response
{ "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/"}