Errors

Errors return a non-2xx status and a JSON body with a human-readable error message plus a machine-readable code where useful.

Errors return a non-2xx status and a JSON body with a human-readable error message, plus a machine-readable code where useful. Scraper input errors add a details string naming the bad field.

400Invalid product, quantity, targeting or scraper input.

401Missing or invalid API key.

402Wallet balance short, or per-key daily spend cap reached.

403Key is missing the required scope.

429Rate limited. Slow down and retry (Retry-After header).

502Upstream failure on a scraper call. Retry shortly. Never billed.

Error response

{
  "error": "This API key is missing the 'buy' scope.",
  "code": "missing_scope"
}

← Previous

Rate limits & retries

Account & wallet

Need a hand wiring this up? Email [email protected]. A real person reads every message.