Get Tweet timelines

Please note:

We launched a new version of the standard v1.1 statuses/user_timeline and statuses/mentions_timeline endpoints as part of Twitter API v2: Early Access. If you are currently using either of these endpoints, you can use our migration materials to start working with the newer endpoint.


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.


Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.