Rate Limiting

Each API key has a configurable rate limit (default: 60 requests per minute). Every response includes rate limit headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1711400460
HeaderDescription
X-RateLimit-LimitMaximum requests per minute for this key
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the window resets

When Rate Limited

Exceeding the limit returns 429 Too Many Requests:

{
    "success": false,
    "error": {
        "code": "RATE_LIMITED",
        "message": "Rate limit exceeded. Try again in 23 seconds.",
        "status": 429
    }
}

The response includes a Retry-After header with the seconds to wait.

Best Practices

  • Check X-RateLimit-Remaining before making requests in tight loops.
  • Implement exponential backoff when you receive a 429.
  • If you need a higher limit, edit the API key in Settings → API Keys.