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

ResourceLimitWindow
Minute6060 seconds (burst capacity 120)
Day5,000UTC day
Month50,000UTC month
Bulk20UTC 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.

Developer documentation