Rate limits

Each API key may make short bursts of up to 20 requests, refilled at 10 per second. That is plenty for autocomplete with a pause between keystrokes.

When you go over#

The request is refused with 429 rate_limit_exceeded and these headers:

Retry-After: 1
RateLimit-Limit: 20
RateLimit-Remaining: 0
RateLimit-Reset: 1

Wait Retry-After seconds, then retry. Successful responses carry no rate-limit headers. The limit applies to every /v1 call, including usage.

Monthly limits#

Three other 429s are about your month, not your pace: spend_cap_reached, fair_use_exceeded and quota_exceeded. They carry resetAt in the body and a Retry-After that points to the start of next month. Retrying sooner will not help. See Billing and fair use.