Skip to main content

​
Default Limits

The V2 API enforces the following rate limits:
LimitValue
Requests per second100 per API key

​
Rate Limit Headers

Rate limit information is included in response headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per window
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetUnix timestamp when the window resets

​
Exceeding Limits

When you exceed the rate limit, the API returns a 429 Too Many Requests response: 
{
  "error": {
    "type": "rate_limit_exceeded",
    "title": "Rate limit exceeded",
    "status": 429,
    "detail": "Too many requests. Please retry after the rate limit resets."
  },
  "metadata": {
    "request_id": "req_xyz789"
  }
}

​
Best Practices

  • Implement exponential backoff when receiving 429 responses
  • Cache responses where appropriate
  • Use pagination to reduce the number of requests

​
Increasing Limits

If you need higher rate limits for your use case, contact support to discuss options.