Rate Limiting

Understand API rate limits and how to handle them.

Rate Limit Overview

To ensure fair usage and platform stability, API requests are rate limited per API key.

Rate Limit Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1234567890

Handling Rate Limits

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

{
  "success": false,
  "message": "Rate limit exceeded",
  "errors": [],
  "timestamp": 1234567890
}

Best Practices

• Implement exponential backoff when receiving 429 responses
• Cache responses when possible
• Use webhooks instead of polling
• Monitor your rate limit headers