Skip to main content

​
Limits by tier

TierRequests/minRequests/monthMax perPage
Free1010010
Starter305,00050
Pro6025,000500
Business120100,000500

​
Response headers

Every response includes rate limit and quota headers: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1708012800
X-Quota-Limit: 25000
X-Quota-Used: 142
X-Quota-Remaining: 24858
X-Request-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

​
Handling 429 responses

When you exceed the rate limit, the API returns a 429 status with a Retry-After header: 
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Retry after 32 seconds.",
    "status": 429,
    "retryAfter": 32
  }
}
Best practices:
  1. Read the Retry-After header and wait before retrying
  2. Implement exponential backoff for repeated 429s
  3. Use the SDK, which handles retries automatically

​
Quota exceeded

When you exceed your monthly quota: 
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Monthly request quota exceeded.",
    "status": 429
  }
}
Quotas reset at the start of each billing period. Check your current usage with the X-Quota-* headers or the /v1/usage endpoint.