Documentation

Rate limits and quotas

Two independent limits, both reported on every successful response.

Two limits

A per-minute rate limit protects burst capacity and is evaluated per API key. A request quota governs billing and is evaluated per subscription — daily on the free plan, monthly on paid plans. Exhausting either answers 429, but with a different error code so you can react correctly.

Response headers

Headers
X-RateLimit-Limit: 2000
X-RateLimit-Remaining: 1987

X-Quota-Period: month
X-Quota-Limit: 2000000
X-Quota-Usage: 412903
X-Quota-Remaining: 1587097

X-Monthly-Limit: 2000000
X-Monthly-Usage: 412903
X-Monthly-Remaining: 1587097

Plan limits

PlanRequestsRequests / minuteAPI keys
Free1,000 / day601
Developer250,000 / month3003
Startup2,000,000 / month2,00010
Business10,000,000 / month10,00025
ScaleUnlimited50,000100

Cache before you scale

This data changes rarely. Respecting the cache headers, or keeping a local copy refreshed daily, will keep almost any application inside a low plan tier.