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:
| Header | Meaning |
|---|---|
RateLimit-Limit | Requests the key may make per window. |
RateLimit-Remaining | Requests left in the current window. |
RateLimit-Reset | Seconds 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.