Rate limits
Per-key request limits and the headers that report them.
Requests are rate limited per API key, with a fixed window.
- 120 requests per minute per key.
Every response includes headers describing your current standing:
| Header | Description |
|---|---|
X-RateLimit-Limit | The ceiling for the window (120). |
X-RateLimit-Remaining | Requests left in the current window. |
X-RateLimit-Reset | Unix time (seconds) when the window resets. |
Retry-After | On a 429, seconds to wait before retrying. |
When you exceed the limit you receive 429 with code rate_limited:
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Slow down and retry.",
"request_id": "…"
}
}Back off using the Retry-After header and spread bulk work over time. Use
cursor pagination with larger limit values to fetch more
per request instead of making many small calls.