Resources
Rate Limits
API rate limiting and quota information
Rate Limiting
API requests are rate-limited to ensure fair usage and service stability.
Limits
| Plan | Requests/min | Requests/month |
|---|---|---|
| Free | 600 | 1,000 |
Rate Limit Headers
Every response includes headers indicating your current usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests per minute |
X-RateLimit-Remaining | Remaining requests in the current window |
X-RateLimit-Reset | Unix timestamp when the limit resets |
Exceeding Limits
When you exceed the rate limit, the API returns a 429 Too Many Requests response:
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Try again in 42 seconds.",
"details": {
"retry_after": 42
}
}
}Best Practices
- Cache responses client-side to reduce API calls
- Use exponential backoff for retries
- Monitor your
X-RateLimit-Remainingheader