How Quotas Work
Every API key has a daily quota and a monthly quota. Each successful request consumes one unit from both quotas.
When you create a key via the Admin Dashboard, the following defaults apply:
| Quota | Default | Maximum |
|---|---|---|
| Daily | 1,000 | Configurable per key |
| Monthly | 10,000 | Configurable per key |
Admins can set custom quotas when creating a key. Once a key reaches its limit, subsequent requests receive a 429 Too Many Requests response until the quota resets.
Rate Limit Responses
When a quota is exceeded, the API returns:
{ "code": 4290, "message": "Daily quota exceeded"}Or for monthly limits:
{ "code": 4291, "message": "Monthly quota exceeded"}| HTTP | Code | Message |
|---|---|---|
| 429 | 4290 | Daily quota exceeded |
| 429 | 4291 | Monthly quota exceeded |
Daily quotas reset at midnight UTC. Monthly quotas reset on the first day of each month.
Checking Usage
You can monitor your API key usage in the Admin Dashboard. The dashboard tracks:
- Total requests per day and month
- Per-endpoint breakdown
- Last used timestamp
Limits on Query Parameters
Query endpoints support pagination with the following limits:
| Parameter | Default | Maximum |
|---|---|---|
limit | 100 | 1,000 |
offset | 0 | No hard limit |
Exceeding the maximum limit silently clamps the value to 1,000.