Errors and outcomes
HTTP status codes
| Status | Meaning |
|---|---|
400 | Invalid JSON, body or URL (unsupported_url for private or non-HTTP targets). |
401 | Missing, unknown or revoked API key. |
402 | insufficient_credits, or a max_credits below the mode's base price (ceiling). |
403 | account_blocked, or stealth mode on a trial account. |
409 | The Idempotency-Key was reused with a different body. |
410 | The result was deleted or has expired. |
429 | An account limit; retry after the Retry-After header. |
503 | Temporary capacity limit; retry shortly. |
Why a job failed
A failed job costs nothing. Its error explains which kind of failure it was:
error | What happened |
|---|---|
blocked | Every allowed level was refused, or the site requires real authentication. |
too_large | The page needed more transfer than max_credits allows. |
extraction_failed | The page loaded but held no usable content, or never finished rendering. |
attempts_exhausted | Transient failures used up the retries. |
timeout | The execution budget ran out. |
queue_expired | The job waited too long for capacity. |