Piloterr

Website WebUnlocker

Bypass advanced anti-bot systems (Cloudflare, DataDome, Akamai, PerimeterX) on whitelisted domains. Combines browser rendering and unlock tooling; use after Crawler and Rendering fail.

Credit cost: 3 credits per call

GET
/v2/website/webunlocker

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

A public website URL to unlock with the WebUnlocker engine. Must include http:// or https://. The target domain must be on Piloterr's approved whitelist.

Example:

https://www.norauto.fr/t/pneu/w-185-h-55-r-14/ete-s/80-l-h-q.html

Choosing the right engine:

  • Try Website Crawler and Website Rendering first when possible (lower cost).
  • Use WebUnlocker only for advanced bot protection on approved domains.
  • Contact Piloterr support to request whitelist access before production.

See Website Scraping guide for a full comparison.

allow_redirects?boolean

Controls whether the WebUnlocker engine should follow HTTP redirects.

  • true: Follow redirects automatically (default)
  • false: Stop at the first HTTP response without following any redirect

Notes:

  • Set to false when you need to inspect the redirect chain or capture intermediate responses.
Default"true"
return_page_source?boolean

Controls whether the response returns the raw, unprocessed HTML source of the page.

  • false: Return processed/parsed content (default)
  • true: Return the exact HTML source as delivered by the web server after bot bypass

Notes:

  • Useful when you need the unmodified server response for debugging or precise parsing.
Default"false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/website/webunlocker?query=string"
"<!DOCTYPE html><html lang=\"fr\"><head><meta charset=\"UTF-8\"><title>Pneus été 185/55 R14 | Norauto</title><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"></head><body><div id=\"app\"><main class=\"product-listing\"><h1>Pneus 185/55 R14 été</h1><div class=\"product-grid\"><div class=\"product-card\"><span class=\"brand\">Goodyear</span><span class=\"price\">89,90€</span></div></div></main></div></body></html>"
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}