Rate Limit & API Usage
All API endpoints are subject to a rate limit per minute. Each response includes headers indicating your current usage and remaining quota.
Rate Limit Headers
| Header name | Header type | Header description |
|---|---|---|
X-RateLimit-Limit |
Integer | Maximum allowed requests per minute. |
X-RateLimit-Remaining |
Integer | Remaining requests in the current minute. |
X-RateLimit-Used |
Integer | Requests already made in the current minute. |
Credit Headers
| Header name | Header type | Header description |
|---|---|---|
X-Credits-Limit |
Integer | Total available credits for your API key (-1 if unlimited). |
X-Credits-Remaining |
Integer | Credits remaining after this request. |
X-Credits-Used |
Integer | Credits consumed by this request. |
If the endpoint does not consume credits, the values will be -1, 0, 0.
Behavior on Exceeding the Limit
If you exceed the allowed rate, the API will return a 429 error code. Wait for the next minute to resume requests.