Rate Limiting
The API limits requests to prevent abuse.
Global Limits
| Time Window | Max. Requests |
|---|---|
| 1 second | 3 |
| 10 seconds | 20 |
| 60 seconds | 100 |
Some endpoints (e.g. stream list, song history) are exempt from global limits as they are designed for frequent queries.
Strict Limits
These endpoints have additional, stricter limits:
| Endpoint | Limit |
|---|---|
POST /user (Registration) | 5 per minute |
POST /user/login | 10 per minute |
POST /user/requestPasswordChange | 5 per minute |
DELETE /user/verify/:token | 5 per minute |
Error Response
When the limit is exceeded, the API responds with:
http
HTTP 429 Too Many Requestsjson
{
"statusCode": 429,
"message": "ThrottlerException: Too Many Requests"
}