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: 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: 600
X-RateLimit-Remaining: 587
X-Quota-Period: month
X-Quota-Limit: 2000000
X-Quota-Usage: 184230
X-Quota-Remaining: 1815770
X-Monthly-Limit: 2000000
X-Monthly-Usage: 184230
X-Monthly-Remaining: 1815770Plan limits
| Plan | Requests | Requests / minute | API keys |
|---|---|---|---|
| Free | 1,000 / day | 30 | 1 |
| Developer | 100,000 / month | 120 | 3 |
| Startup | 2,000,000 / month | 600 | 10 |
| Business | Unlimited | 2,000 | 25 |
| Scale | Unlimited | 10,000 | 100 |
Handling 429
A rate limit rejection carries Retry-After in seconds; wait that long and retry with jitter. A quota rejection will not clear until the period resets (midnight UTC on free, billing date on paid), so upgrade the plan instead of retrying.