Rate Limits

Rate limits are enforced per API key at both per-minute and per-month levels.

Limits by Plan

PlanRequests/MonthRequests/MinutePrice
Free2505$0
Basic5,00030$29/mo
Pro50,000120$79/mo
Enterprise500,000500$299/mo

Rate Limit Headers

Every API response includes rate limit headers:

Response Headers
X-RateLimit-Limit-Minute: 30
X-RateLimit-Remaining-Minute: 28
X-RateLimit-Limit-Month: 5000
X-RateLimit-Remaining-Month: 4832

Handling 429 Responses

When you exceed a rate limit, you'll receive a 429 Too Many Requests response:

429 Response
{
  "detail": "Rate limit exceeded. 5 requests per minute allowed on your plan."
}

Best practice: implement exponential backoff. Wait 1 second, then 2, then 4, etc. Check the rate limit headers to avoid hitting limits.