Rate Limits
API rate limits by plan tier.
Limits by Plan
| Plan | Requests/month | Burst (per minute) |
|---|---|---|
| FREE | 1,000 | 20 |
| STARTER | 10,000 | 60 |
| PRO | 100,000 | 200 |
| ENTERPRISE | Custom | Custom |
Response Headers
Every API response includes rate limit headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Total requests allowed in current window |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Retry-After | Seconds until you can retry (only on 429) |
Rate Limit Exceeded
When you exceed your rate limit, you'll receive a 429 Too Many Requests response:
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Please try again later.",
"retryAfter": 42
}
}Best Practices
- Cache responses — Use the SDK's built-in cache or your own
- Use pagination — Don't fetch all content in one request
- Batch operations — Group writes where possible
- Monitor headers — Check
X-RateLimit-Remainingto avoid hitting limits - Implement backoff — On 429, wait for
Retry-Afterseconds