Get Tweet timelines

Please note:

We've recently released the following endpoints within the Twitter API v2 . The new version is currently in development and serves adequate access for the majority of developers on our platform. While elevated levels of access are coming soon, developers in need of higher levels of access can explore our v1.1 premium or enterprise APIs to see if those products might work with your use case, or apply for an elevation.

v1.1 endpoints Corresponding v2 endpoints  
GET statuses/user_timeline User Tweet timeline Comparison guide
GET statuses/user_mentions User mention timeline Comparison guide

Please use the comparison guides to see what has changed between the standard v1.1 and v2 versions.


Important notice:  On June 19, 2019, we began limiting total GET requests to the v1.1 /statuses/mentions_timeline and /statuses/user_timeline endpoints to 100,000 requests per day. This is a total request limit (per endpoint) applied across both user-auth and app-auth requests. This means that in a 24-hour period, a single app can make up to 100,000 requests to /statuses/mentions_timeline and/or 100,000 requests to /statuses/user_timeline (with either app or user auth) before hitting this new app-level rate limit. The existing default user-auth and app-auth rate limits remain the same.

A timeline is simply a list, or an aggregated stream of Tweets.  The Twitter API has several endpoints that return a timeline of Tweet data - see the table below for more details:

API endpoint Description

GET statuses / home_timeline

Returns a collection of the most recent Tweets posted by the authenticating user and the users they follow.
GET statuses / user_timeline
Returns a collection of the most recent Tweets posted by the indicated by the screen_name or user_id parameters.
GET statuses/mentions_timeline
Returns the 20 most recent mentions (Tweets containing a users’s @handle) for the authenticating user.