Skip to Content

Rate limits

The per-key request budget and its headers.

Each API key has a request budget per time window. By default that is 600 requests per 60 seconds.

Successful responses carry the budget in headers:

HeaderMeaning
RateLimit-LimitRequests the key may make per window.
RateLimit-RemainingRequests left in the current window.
RateLimit-ResetSeconds until the current window resets.

When the budget is spent, requests are refused with 429 and the code rate_limited. The Retry-After header says how many seconds to wait.

{
  "error": {
    "code": "rate_limited",
    "message": "This API key made too many requests. Try again in 12 seconds."
  }
}

Spread requests out, and wait for Retry-After before you retry.