Today, we are launching reverse chronological home timeline to the Twitter API v2 to enable you to retrieve the most recent Tweets and Retweets posted by the authenticated user and the accounts they follow. We know this functionality is important to numerous developer use-cases and we will continue to prioritize innovation and functionality that allows you to build with the core elements of the Twitter experience.
“The 1.1 home_timeline API is one of our most used API calls. The increased rate and pagination Tweet limits of v2 are going to be a noticeable benefit for our users. Given how crucial this call is, it really underscores Twitter’s continuing commitment to modernizing their API” – Paul Haddad of Tweetbot
Get started
All developers building with the Twitter API v2 can begin using these endpoints right away. If you haven’t already, sign up for a developer account, and check out our documentation for more information on getting started.
Since you are making requests on behalf of a user, you must authenticate these endpoints using an OAuth 2.0 Authorization Code Flow with PKCE or OAuth 1.0a User Context. This endpoint has a per-user rate limit of 180 requests per a 15 min window.
The reverse chronological home timeline v2 endpoint can return every Tweet created on a timeline over the last 7 days and the most recent 800 regardless of the creation date.
What can you build with this endpoint?
Based on the feedback we’ve heard from people on Twitter, here are just some of the use-cases you might consider building:
Check out your top Tweet topics
Have you ever wished you could know what Tweet topics come up most? Using Tweet annotations and reverse chronological home timeline, you can build an application that shows you many Tweets per top topic you have in your home timeline based on each Tweet’s annotations.
Check out our Glitch app, where you can try out this functionality yourself.
View your home timeline from a specific moment in time
Did a major event occur recently? Are you wondering what your home timeline looked like while it was happening? You can use start_time and end_time query parameters to view your home timeline during a focal point in the public conversation.
Good vibes only
You can use sentiment analysis combined with this endpoint to append sentiment scores to each Tweet in your home timeline and filter out negative Tweets.
We can’t wait to see what you build
We’re continuing to add new features and functionality to Twitter API v2. Be sure to keep an eye on our public roadmap for the latest. As always, we’d love to hear what you think. Please reach out with any questions or feedback on improving this endpoint. Be sure to Tweet us at @TwitterDev to let us know what you build!
