Rate Limiting

NekoSauce has to rate limit the use of it’s API to avoid abuse. Currently, our server resources are not enough to handle the amount of requests that we get so the limit can be quite restrictive for some applications.

The global rate limit is of 1 request per second. There is no going faster than that. However, the /search endpoint has a much higher limt, which is a request every 10 seconds. This limit is lowered for donators since they help us cover the server costs, and therefore they deserve more server resources dedicated to them.

​

Headers

The API will return the following headers in all responses:

​

Blocking

If you got rate limited, you’ll receive a 429 Too Many Requests response:

{
  "errors": [
    {
      "status": "too_many_requests",
      "message": "Wait nyan, I cannot go that fast >.<! Don't speed up like that again or you'll end up getting blocked for longer than usual.",
      "code": 429,
    },
  ]
}