Piloterr

Website WebUnlocker

WebUnlocker is a hybrid of realistic JS rendering and request-mode crawling, engineered to bypass advanced anti-bot systems on whitelisted websites.

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 website URL to unlock using the WebUnlocker engine. Must include the http or https protocol. 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

Examples of supported domains: mobile.de, leroymerlin.fr, norauto.fr

Notes:

  • Beta endpoint: Features and functionality may change as the service is improved.
  • Whitelist required: Contact Piloterr support to request adding a new domain to the authorized list before use.
  • Choosing the right API can be tricky this guide will point you to the best option: Website Scraping
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"
}