Rate limiting
The API enforces IP-based rate limiting to ensure fair usage across all clients.
Response headers
Section titled “Response headers”Every response includes headers indicating your current rate limit status:
| Header | Description |
|---|---|
X-RateLimit-IPLimit | Maximum requests allowed in the current window |
X-RateLimit-IPRemaining | Requests remaining in the current window |
Authenticated requests (those with a valid X-API-Key header) receive a higher allowance than unauthenticated requests.
Exceeding the limit
Section titled “Exceeding the limit”Requests over the allowed quota return 429 Too Many Requests. When this happens, back off and wait before retrying. Monitor the X-RateLimit-IPRemaining header to pace your requests and avoid hitting the limit.