Documentation

Common error shape

{
  "error": {
    "code": 400,
    "message": "proxyCountry requires premiumProxy to be true"
  }
}

A few legacy specialised routes still return { "error": "…" }. Handle both forms with error.message ?? error.

Invalid URL

The url is checked before the scrape, so an invalid address costs no credit. The response says what is wrong in message and details and, when the mistake is clear, gives the corrected address in suggestedUrl (missing https://, missing / after the domain name, spaces, quotes…).

{
  "error": {
    "code": 400,
    "message": "Invalid URL: unknown domain extension \".frdp\"",
    "details": "A \"/\" is probably missing between the domain name and the rest of the address.",
    "suggestedUrl": "https://www.amazon.fr/dp/B0D1"
  }
}