Rate Limiting & Quotas
Each API plan comes with a daily quota of tokens. Every API call you make costs a certain amount of tokens. At the bottom of each endpoint description you will find information about the number of tokens required for that endpoint.
When you are on the free plan and your daily quota is used up, the API will respond with the error code 402 and no more calls can be made until your quota resets.
You have complete control over your quota by looking at your console dashboard and checking the API response headers that appear with every answer from the API. These response headers are:
X-API-Quota-Request
: The number of tokens used by the request.X-API-Quota-Used
: The number of tokens used in total today. This number resets to zero at midnight UTC (click here to compare to your local time zone).X-API-Quota-Left
: The number of tokens left today (depends on your plan).
Rate Limiting
There is a limit to how many requests you can make per second and how many requests you can make simultaneously (concurrent requests). The specific limits depend on your API plan. If you exceed these limits, you will receive an HTTP 429 error.
The rate limits for each plan are as follows:
- Free: 60 requests per minute and 1 request at a time (1 concurrent request)
- High Score: 2 requests per second and 2 requests simultaneously
- God Mode: 5 requests per second and 10 requests simultaneously