Standard API rate limits per window
Standard
POST endpoints
The standard API rate limits described in this table refer to POST endpoints. These rate limits apply to the standard API endpoints only, does not apply to premium APIs.
Endpoint | Resource family | POST limit window | POST per user limit | POST per app limit |
POST statuses/update |
create content | 3 hours* | 300* | 300* |
POST statuses/retweet/:id |
create content | 3 hours* | 300* | 300* |
POST favorites/create |
favorites | 24 hours | 1000 | 1000 |
POST friendships/create |
friendships | 24 hours | 400 | 1000 |
POST direct_messages/events/new |
direct messages | 24 hours | 1000 | 15000 |
Please note - The 300 per 3 hours is with the POST statuses/update and POST statuses/retweet/:id endpoints is a combined limit. You can only post 300 Tweets or Retweets during a 3 hour period.
For example, if your Twitter app makes 200 requests to the POST statuses/update endpoint within a three hour period, your app will only be able to make 100 requests to the POST statuses/retweet/:id endpoint during that period.
GET endpoints
The standard API rate limits described in this table refer to GET (read) endpoints. Note that endpoints not listed in the chart default to 15 requests per allotted user. All request windows are 15 minutes in length. These rate limits apply to the standard API endpoints only, does not apply to premium APIs.
Endpoint | Resource family | Requests / window (user auth) | Requests / window (app auth) |
---|---|---|---|
GET account/verify_credentials | application | 75 | 0 |
GET application/rate_limit_status | application | 180 | 180 |
GET favorites/list | favorites | 75 | 75 |
GET followers/ids | followers | 15 | 15 |
GET followers/list | followers | 15 | 15 |
GET friends/ids | friends | 15 | 15 |
GET friends/list | friends | 15 | 15 |
GET friendships/show | friendships | 180 | 15 |
GET geo/id/:place_id | geo | 75 | 0 |
GET help/configuration | help | 15 | 15 |
GET help/languages | help | 15 | 15 |
GET help/privacy | help | 15 | 15 |
GET help/tos | help | 15 | 15 |
GET lists/list | lists | 15 | 15 |
GET lists/members | lists | 900 | 75 |
GET lists/members/show | lists | 15 | 15 |
GET lists/memberships | lists | 75 | 75 |
GET lists/ownerships | lists | 15 | 15 |
GET lists/show | lists | 75 | 75 |
GET lists/statuses | lists | 900 | 900 |
GET lists/subscribers | lists | 180 | 15 |
GET lists/subscribers/show | lists | 15 | 15 |
GET lists/subscriptions | lists | 15 | 15 |
GET search/tweets | search | 180 | 450 |
GET statuses/lookup | statuses | 900 | 300 |
GET statuses/mentions_timeline | statuses | 75 | 0 |
GET statuses/retweeters/ids | statuses | 75 | 300 |
GET statuses/retweets_of_me | statuses | 75 | 0 |
GET statuses/retweets/:id | statuses | 75 | 300 |
GET statuses/show/:id | statuses | 900 | 900 |
GET statuses/user_timeline | statuses | 900 | 1500 |
GET trends/available | trends | 75 | 75 |
GET trends/closest | trends | 75 | 75 |
GET trends/place | trends | 75 | 75 |
GET users/lookup | users | 900 | 300 |
GET users/search | users | 900 | 0 |
GET users/show | users | 900 | 900 |
GET users/suggestions | users | 15 | 15 |
GET users/suggestions/:slug | users | 15 | 15 |
GET users/suggestions/:slug/members | users | 15 | 15 |