Get started

Rate limits

Rate limiting protects the API from bursts; it is separate from your credit quota. Exceeding it returns 429 with a Retry-After header.

429 response

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded",
  "request_id": "8f3c2a1e-5b7d-4c9a-9e2f-1a2b3c4d5e6f"
}

Per-key sliding window. Exceeding it returns 429.

How to handle it

Read Retry-After (seconds) and wait at least that long.
Retry with exponential backoff and jitter; cap at 3 attempts.
Spread bulk work over time instead of bursting; parallelism rarely beats the per-key limit.
A 403 quota_exceeded is different: your credit balance is exhausted. Top up in the dashboard.

Need a higher limit? Contact us from the dashboard with your key prefix and expected throughput.