Rate Limits
API usage is rate-limited based on your subscription tier.
Limits by Tier
| Tier | Request Limit | Reset Period |
|---|---|---|
| Free | 100 requests | Monthly |
| Pro | 2,000 requests | Monthly |
| Business | 10,000 requests | Monthly |
Rate Limit Headers
Every API response includes headers to help you track your usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests permitted per month |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Time when rate limit resets (UTC ISO 8601) |
Example Headers
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 84
X-RateLimit-Reset: 2024-02-01T00:00:00.000ZHandling Rate Limits
When you exceed your rate limit, the API returns a 429 Too Many Requests response.
Best Practices
- • Monitor the X-RateLimit-Remaining header
- • Implement exponential backoff for retries
- • Cache responses when possible
- • Upgrade your tier if you consistently hit limits