Rate limits

Defining how often you can call the REST API

Headers

Rate limit information is returned in the response headers:

X-RateLimit-Limit
Number of requests permitted per time period
X-RateLimit-Remaining
Number of requests you can still make
X-RateLimit-Reset
Timestamp when your rate limit will reset
An API method can be subject to multiple overlapping rate limits. The headers return information about the one you are closest to exceeding.

Limits

By default, the following limits are hardcoded:

Per account

All endpoints and methods can be called 300 times within 5 minutes.

Uploading media

POST /api/v1/media can be called 30 times within 30 minutes.

Deleting statuses

Either DELETE /api/v1/statuses/:id or POST /api/v1/statuses/:id/unreblog can be called 30 times within 30 minutes.

Per IP

All endpoints and methods can be called 300 times within 5 minutes.

Creating accounts

POST /api/v1/accounts can be called 5 times within 30 minutes.

Last updated · Improve this page