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.
Overview
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 |
|---|---|
| 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. |
