Rate Limits

All API endpoints are rate limited per API key to ensure fair usage and platform stability.

Current Limits

Rate Limit Headers

Every response includes headers indicating your current usage:

Exceeding the Limit

When you exceed the rate limit, the API returns a 429 Too Many Requests response:

Code
 
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after the reset window.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Best Practices

• Monitor the x-ratelimit-remaining header to proactively throttle requests
• Use updated_since filters for incremental syncing instead of full re-fetches
• Set ?limit=200 when syncing large datasets to minimize the number of requests
• Implement exponential backoff when you receive a 429 response
• Cache responses where possible to reduce unnecessary calls