Getting Started
Rate Limiting
The API enforces rate limits per API key to ensure fair usage and platform stability.
Current Limits
Each API key is limited to 30 requests per minute. This applies across all endpoints. The window resets on a rolling basis.
Response Headers
Every response includes rate limit headers so you can track your usage programmatically:
| Parameter | Type | Description |
|---|---|---|
X-RateLimit-Limit | number | Maximum requests allowed per window (30) |
X-RateLimit-Remaining | number | Requests remaining in the current window |
X-RateLimit-Reset | number | Unix timestamp (seconds) when the window resets |
Retry-After | number | Seconds until the next request is allowed (only on 429 responses) |
When You Hit the Limit
If you exceed the rate limit, the API returns a 429 Too Many Requests response:
HTTP/1.1 429 Too Many Requests
Retry-After: 34
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1713625200
{
"error": "Rate limit exceeded"
}Best practice
Read the
Retry-After header and wait that many seconds before retrying. Avoid tight retry loops.