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 with a Retry-After header indicating how many seconds to wait before retrying. Monitor the X-RateLimit-IPRemaining header to pace your requests and avoid hitting the limit.
The TypeScript SDK handles rate limiting automatically, retrying with the Retry-After delay.