Skip to content
A nime S chedule .net

Are you sure?

Rate Limits

When using the AnimeSchedule.net API you should be aware that there are limits in place to the total amount of requests you can make in a given period of time. These are called rate limits.

The global rate limit is set to 120 requests per minute. Please be aware that this rate limit can change at any point.

To help automate the the handling of rate limits you will receive headers in every request response that will indicate the state of the rate limits. These headers are documented below.

X-RateLimit-Limit represents what the limit at that endpoint is (e.g. 120.)
X-RateLimit-Remaining represents how many requests you are allowed to make in the remaining time (e.g. 20.)
X-RateLimit-Reset represents a UNIX timestamp of when the rate limit resets.
Restrictions

Every rate limit is both IP and app based. This means that both your IP and the specific app are being rate limited separately and simply making a new app will not decrease your IP's rate limit. Attempts to circumvent the rate limits will be considered abuse of the API as stated in the API Terms of Use.

If your application needs their rate limits raised for a justifiable reason, feel free to contact us at [email protected] or https://animeschedule.net/contact with a showcase of what your application does (description, links, etc.), evidence that it needs higher rate limits and by how much, your AnimeSchedule username, the AnimeSchedule application ID and the IP whose rate limits you wish to raise.

OAuth2

Developers whose apps use OAuth2 should know that there is a special behavior for OAuth2 rate limits. To allow your application to handle a great number of users, as is usually the case with OAuth2 endpoints, each OAuth2 endpoint will link rate limit your application only in relation to the user for whom you are making a request.

What this means is that every user on whose behalf you are making a request for is a unique rate limit and will not affect your rate limit in non-OAuth2 endpoints, IP limit or other user's OAuth2 endpoints.