Rate limits
Limits keep the API fast and fair for everyone. They scale with your plan.
Limits by plan
| Plan | Requests / second | Burst |
|---|---|---|
| Free | 5 | 10 |
| Pro | 25 | 50 |
| Scale | 100 | 200 |
| Enterprise | Custom | Custom |
Response headers
Every response includes headers describing your current limit window.
| Header | Description |
|---|---|
X-RateLimit-Limit | Max requests allowed in the window |
X-RateLimit-Remaining | Requests remaining in the window |
X-RateLimit-Reset | Unix time when the window resets |
Best practices
- Read the rate-limit headers and back off before you’re throttled.
- On a
429, retry with exponential backoff and jitter. - Cache results on your side for queries you repeat often.
- Batch background jobs instead of bursting all at once.