Rate Limiting

Rate limiting protects the API from abuse and ensures fair usage across all users. When you exceed the rate limit, requests will return a 429 Too Many Requests response.

Response Headers

Rate limit information is included in response headers:

X-RateLimit-Remaining: 95
X-RateLimit-Limit: 100
X-RateLimit-Reset: 1704067260

• X-RateLimit-Remaining - Requests remaining in current window
• X-RateLimit-Limit - Total requests allowed in window
• X-RateLimit-Reset - Unix timestamp when window resets

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

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "retry_after": 45
}

The Retry-After header indicates seconds to wait before retrying.

Best Practices

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

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      const delay = retryAfter * 1000 * Math.pow(2, i); // Exponential backoff
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

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

Need Higher Limits?