Skip to main content

​
Default limits

Every API key is rate-limited to prevent abuse and ensure fair access.
LimitDefault
Requests per minute60
Per-key overrideConfigurable per key

​
Response headers

Every response includes rate-limit headers:
HeaderDescription
X-RateLimit-LimitMax requests allowed in the window
X-RateLimit-RemainingRequests remaining
X-RateLimit-ResetUnix timestamp when the window resets

​
Exceeding the limit

When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header: 
{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry after 12 seconds."
  }
}

​
Handling 429 errors

1

Read the Retry-After header

The header value tells you how many seconds to wait.
2

Back off and retry

Use exponential backoff: wait the Retry-After value, then double on each subsequent retry.
3

Optimize your calls

Batch operations where possible and cache responses to reduce call volume.