api reference · v1

Rate limits

Updated May 12, 2026

Each API key has a per-minute and per-month cap. Cross either and the next request returns 429 with a Retry-After header.

Tier caps

tierper minuteper monthoverage
Free6010,000None — requests past the cap return 429 until the next window.
Pro6001,000,000$0.0001 per request after the included 1M.

See pricing for the full breakdown and how to upgrade.

Response headers

Every successful response carries the headers below so you can ramp gracefully without parsing 429s.

headermeaning
X-RateLimit-Daily-UsedNumber of requests made by this key today (UTC).
X-RateLimit-Daily-CapDaily ceiling for the current tier.
Retry-AfterPresent on 429 responses. Seconds to wait before retrying.

Burst tolerance

The per-minute cap allows short bursts up to roughly 2× the steady-state rate before throttling kicks in. Sustained traffic above the cap will always 429 — for predictable high volume, talk to us about Pro or a dedicated tier.

Where to next

  • Errors → 429 handling and other status codes.
  • SDKs → the Python client retries 429/503 with exponential backoff.