Rate limits
Defining how often you can hit the REST API
Rate limit information is returned in the response headers:
| Header | Description |
|---|---|
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 |
Mind that an API method can be subject to multiple overlapping rate limits. The headers return information about the one you are closest to exceeding.
Here is a list of various rate limits:
| Endpoint | Bucket | Time period | Limit | Limit type |
|---|---|---|---|---|
* /api/* |
Account access | 5 minutes | 300 | Account |
* /api/* |
IP access | 5 minutes | 300 | IP |
POST /api/v1/accounts |
App sign-up | 30 minutes | 5 | IP |
POST /api/v1/media |
Uploading | 30 minutes | 30 | Account |
DELETE /api/v1/statuses/:id |
Deletion | 30 minutes | 30 | Account |
POST /api/v1/statuses/:id/unreblog |
Deletion | 30 minutes | 30 | Account |
Last updated March 5, 2020 · Improve this page