Rate limits
Keyed API quotas, response headers, 304 behavior, and safe retry handling.
Limits apply only to the keyed host. The open static files do not use a key or return keyed quota headers.
Default keyed limits
| Resource | Limit | Window |
|---|---|---|
| Minute | 60 | 60 seconds (burst capacity 120) |
| Day | 5,000 | UTC day |
| Month | 50,000 | UTC month |
| Bulk | 20 | UTC day |
Rate-limit headers
X-RateLimit-Limit- Limit for the resource named by X-RateLimit-Resource.
X-RateLimit-Remaining- Requests remaining for that resource. Never negative.
X-RateLimit-Reset- Unix time in seconds when that resource resets or the next minute token is available.
X-RateLimit-Resource- The closest active constraint: minute, day, month, or bulk.
RateLimit-Policy- Minute, day, and month policies in the response’s structured policy string.
Retry-After- Seconds to wait. Present when the service can state a retry delay.
304 responses
A matching keyed conditional request consumes the minute bucket but does not increment day, month or bulk counters.
429 responses
On 429, wait the number of seconds in Retry-After, bound retries and try again.