Ratelimits

Ratelimits

Every endpoint in this API will be ratelimited, meaning that you cannot send more than a specific amount of requests to an endpoint over a certain period of time. If you exceed the amount of requests allowed, you will be faced with a 429 Too Many Requests error. Ratelimits completely ignore path parameters. For example, if you used GET /v1/users/:id with the ID of 1, you would still be ratelimited even if you changed the ID to 2. Ratelimits are limited by Authorization header, and uses IP as a fallback if no authorization is provided. Attempting to bypass or circumvent ratelimits will result in a ban from the site and our APIs.

Good Practices

Some services may exceed these ratelimits from time to time, that is why you should cache when possible. For example, if you owned a command in a Discord bot that retrieved server information upon request, you shouldn't perform a request each time, instead you should cache the result from /v1/servers and update the cache every minute or so.

Large Scale Services

Some services may require extended ratelimits, or even ratelimit removal. If you believe that your service is too large, ratelimits may be removed upon request under certain circumstances with approval. If think that you need this, you may contact us on our Contact page. Make sure to provide proof of how large your service is.

Endpoints

Endpoint

Ratelimit

GET /v1/statistics

1 per second

GET /v1/servers

15 per 2 minutes

GET /v1/servers/:id

6 per 15 seconds

GET /v1/servers/:id/upvotes

15 per 15 seconds

GET /v1/users/:id

2 per second

GET /v1/users/:id/servers

6 per 15 seconds

‚Äč