The Twitter API v2 is ready for prime time! Over the past 14 months, we have been steadily releasing net new and v1.1 replacement endpoints to Twitter API v2, and today 90% of all existing apps built on the Twitter API v1.1 can be fully supported on v2 with new key features and increased access.
Twitter API v2 overview to-date
If you’re new to Twitter API v2, here are a few highlights of what we’ve released to-date:
- Over 50 endpoints that enable you to analyze, measure, study, or improve the way people participate in the public conversation on Twitter.
- Net-new endpoints that weren’t previously available on previous versions of the Twitter API, including:
-
Hide replies, which allows you to build tools that help limit the impact of abusive, distracting, or misleading replies at scale - a crucial piece to improving the health of the public conversation on Twitter, and ensuring brands and people feel comfortable starting conversations.
- New manage Tweet endpoints, which allow people to participate in the public conversation in new ways, through functionality like poll creation, Tweet reply settings, tagging people in images, and the ability to Tweet to Super Followers.
-
Spaces endpoints to help people get more out of Twitter Spaces, and to allow developers to help shape the future of audio conversations.
- New updates to Likes endpoints, so you can retrieve a list of people who have liked a given Tweet.
-
New Lists endpoints that allow you to pin and unpin Lists, or look up someone’s pinned Lists.
- New batch compliance endpoints that allow you to ensure your stored user and Tweet data is in compliance.
- Better control which fields and objects you receive in payloads using new fields and expansions parameters.
- New response fields, including advanced metrics, annotations to help categorize Tweets based on their content, poll results, and conversation IDs to help you track all the Tweets included in a reply thread.
-
Advanced filtering functionality to help you find relevant historical or real-time content and conversations more quickly.
- Elevated access and advanced functionality for academic researchers.
- A new developer portal experience that allows developers to manage their Projects, Apps, and access to Twitter API products.
Today’s launch
And today, we are adding the following updates to the list:
- Fast and free Essential access (sign up) to the API, and free Elevated access to developers who have had their use cases approved. We have more details on these access levels in our About Twitter API guide, and later in this post.
- We are removing language in our Developer Policy that restricted how you build with Twitter’s core features, and limited the number of users you can support through your app.
- We are opening up our platform to encourage you to build tools and products that make Twitter better, healthier, and extend the public conversation. See a list of solutions we’d love to see you build.
- Specifically, we’ve removed terms that restricted replication of the Twitter experience, including Twitter’s core features as well as terms that required permission to have high numbers of user tokens.
- We know that building solutions that help people on Twitter often means a developer has to build (or replicate) some of the things that are available on Twitter. These changes to our Developer Policy are intended to drive clarity for the developer ecosystem and provide an open API platform that makes it easier for developers to build, innovate, and make an impact on the public conversation.
- We’re adding new functionality to the Spaces endpoints.
- Creators can look up the list of people who purchased a ticket to their Spaces. This list returns full user objects and is available only when the request is made by the creator of a ticketed Space.
- The Space object now returns topics associated with a Space, as well as the end time of an ended Space.
- We’re completing the v2 Lists endpoint group today with the addition of a variety of different GET Lists endpoints.
- These endpoints will enable users to build solutions that solve for curation, discoverability, and analysis needs.
- New List object returned with many of the endpoints.
- New functionality to the group that allows developers to lookup user’s pinned Lists.
We do still plan to release updated versions of the Direct Messages, trends, media, and geo endpoints soon. You can see a list of how the v1.1 endpoints map to our v2 replacements in our endpoint map guide, and can follow along via our product roadmap.
Also, for those with a need for access beyond 2M Tweets/month, or who need advanced reliability and scale features like redundancy and larger caps on search requests, please join our waitlist to receive updates about our future product plans for access beyond Elevated. If you need greater access immediately, please consider our enterprise APIs.
For those of you who are currently in a managed relationship with our team and using enterprise APIs today, you can read a separate FAQ to help you understand how we plan to support you as we continue to build v2.
And a final note on upcoming plans: We’re working on a solution to enable developers whose previous applications for a developer account have been declined. We’ll share a path soon to enable sign up for Essential, or to re-apply for Elevated access.
Are you new to the platform and ready to get started?
We encourage you to sign up for Essential access and make your first request to the API.
Once you sign up, you will have a project with Essential access within your account which will provide you with the following:
If you need more access than this, you can apply for Elevated access.
How about those of you that are already on the platform?
If you’ve already been approved for a developer account, your Standard Project will automatically be converted to a Project with Elevated access, which will now provide you with the following:
If you are an academic researcher, you may continue to be served by Academic Research access to the API v2. Learn more on the Academic Research page.
For those of you that have already been using the platform, we’ve put together a migration hub to help you learn more about what’s new on the platform and how to update your integration to v2. We’ve also produced migration guides for each v2 endpoint that you can find within their respective section.
Ready to build?
Head to our documentation to learn more about what’s available. We also have tutorials that can help you get started with different tools and use cases.
We particularly want to encourage new innovation and growth around a few areas that we believe can have the greatest impact on the world, and on Twitter. You can read more about each of these on our ‘what to build’ page.
- Improve the health and safety of the public conversation (through moderation and more)
- Curate and recommend content
- Help people create, express themselves, and engage with one another
- Make it easier for people around the world to converse no matter their language or location
- Help people measure, analyze, and find insights within the public conversation
- Support the public good
So what has the community built with Twitter API v2 to date?
The Twitter API v2 is ripe with opportunity, and the community has already been building some amazing tools. Here, we highlight a few that we’re particularly excited about:
-
Tracy Chou, created Blockparty to help filter unwanted spam or hate
-
Samir Al-Battran, built a business out of Tweetsmap
-
Stein Monteiro, a researcher understanding Twitter’s impact on the farming protests in India
-
Black Swan Data enables brands to build product innovation programs by identifying, connecting, and predicting emerging consumer trends.
- Dan Rowden added a Spaces analytics dashboard to ilo
-
Direcon now supports the ability to track and get host analytics for your Twitter Spaces
Speaking of community, we have a series of different community initiatives kicking off related to this launch:
Also, consider following our Twitter Developer Insiders to see how other developers are building with the Twitter API.
As always, you can follow us on Twitter, YouTube, Twitch, subscribe to this forum category, or find another way to stay informed about product news and tips. We are also excited to hear your feedback.
