Rate Limits
API rate limiting and usage quotas
Rate Limits
The API implements rate limiting to ensure fair usage and system stability.
Rate Limit Headers
Every API response includes rate limit information in the headers:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640000000Limits by Plan
- Free Plan: 100 requests per day
- Pro Plan: 10,000 requests per day
- Enterprise Plan: Custom limits
Handling Rate Limits
When you exceed the rate limit, the API returns a 429 Too Many Requests status code:
{
"code": 429,
"msg": "Rate limit exceeded. Please try again later."
}Best Practices
- Monitor rate limit headers in responses
- Implement exponential backoff for retries
- Cache responses when possible
- Use webhooks instead of polling when available
- Contact support for higher limits if needed
Aidir Docs