Rate Limits

Rate Limits

All API requests are rate-limited per API key using a sliding window. Limits vary by endpoint category:

Rate Limit Headers

Every response includes rate limit headers:

Handling Rate Limits

When rate limited, you'll receive a 429 Too Many Requests response with a Retry-After header:

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 30 seconds."
  }
}

Best Practices

• Check X-RateLimit-Remaining before making requests
• Use the Retry-After header to wait before retrying
• Implement exponential backoff for retries
• Use idempotency keys to safely retry failed requests
• For bulk operations, space requests evenly within the rate window

async function fetchWithRetry(url: string, options: RequestInit, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '30');
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}