Status codes

Standard HTTP semantics. Failed scrapes (4xx/5xx from the source) are never billed.

200Success. Data in the envelope.

400Invalid input. Check the parameters.

401Missing or invalid API key.

402Insufficient balance. Top up your wallet.

404Unknown endpoint.

429Rate limited. Back off and retry (Retry-After header).

502Upstream error. Retry shortly. Not billed.

Good to know

Idempotency: send an X-Request-Id header and retries return the original result without re-charging.

Pay per success: one call, one charge. Never multiplied by record count. Minimum $0.01 per call.

Auth: send X-API-Key or Authorization: Bearer. Both work.

Was this helpful?