Rate limits
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, and are tied to a Twitter user's account limits.
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 with the POST statuses/update and POST statuses/retweet/:id endpoints is a combined limit. A user 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 additionally 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; premium endpoints have different limits based on subscription tiers.
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 |