Rate Limits

API rate limits protect the system from abuse.

Default Limits

Tier	Requests/Minute	Requests/Hour
Free	60	1,000
Pro	300	10,000
Enterprise	Custom	Custom

Headers

Rate limit info is included in response headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1642000000

Handling Limits

When rate limited, you'll receive:

HTTP/1.1 429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 60 seconds.",
    "retry_after": 60
  }
}

Best Practices

1. Implement backoff: Exponential backoff on 429 responses
2. Cache responses: Reduce unnecessary requests
3. Batch operations: Use bulk endpoints when available
4. Monitor usage: Track your rate limit consumption