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