Rate Limits

Overview

Rate limits protect our API infrastructure and ensure fair usage for all users. Each subscription tier has different rate limits based on your needs.

Rate Limits by Tier

Rate Limit Headers

Every API response includes headers that tell you about your current rate limit status:

X-RateLimit-Limit: 100        # Your rate limit per minute
X-RateLimit-Remaining: 85     # Requests remaining in current window
X-RateLimit-Reset: 1640000000 # Unix timestamp when limit resets

Handling Rate Limit Errors

When you exceed your rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "retryAfter": 45
  }
}

The retryAfter field tells you how many seconds to wait before making another request.

Best Practices

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('X-RateLimit-Reset');
      await new Promise(resolve => 
        setTimeout(resolve, retryAfter * 1000)
      );
      continue;
    }
    
    return response;
  }
  throw new Error('Max retries exceeded');
}

Need Higher Limits?

If you're consistently hitting rate limits, upgrade to get higher limits: