Docs · Getting started

Errors and retry strategy

Predictable error codes and a recommended retry pattern.

GET /v1/*

Every error response is JSON with a status of error or a clear detail message. Errors are stable: 401 means re-auth, 429 means wait, 5xx means retry with backoff.

Request

# A failed scrape returns:

Response

{
  "status": "error",
  "url": "https://example.com",
  "error": "Timeout after 30s",
  "time_ms": 30042
}

Errors

Code Meaning
400 Malformed request body or missing required field.
401 Auth failed — check your API key.
404 Resource (such as a job_id) not found.
429 Rate limit or monthly quota exceeded.
500 Upstream fetch failed. Retry with backoff.
503 Endpoint temporarily disabled. Check the status page.

Related

GET /v1/me
Rate limits and quotas