We have launched enhancements to the developer portal and made these available to all developers as part of Early Access to the new Twitter API. This includes an onboarding experience for new developers, an API helper tool to help you make your first requests quickly and features to help you get started quickly and efficiently. The look and feel in the developer portal may look different than it has the past and has simplified navigation to help you find what you need. To learn more about what new features we’ve created, be sure to check out the developer portal tour.
The onboarding wizard guides you through the process of setting up your first Project and App. You will need to create a Project and App to receive the credentials required to authenticate your API requests. You will see the wizard if you are accessing your developer account for the first time.
The credentials you receive in the wizard will include your API key, API secret key, and a bearer token. To learn more about what is needed to authenticate with the Twitter API, take a look at the authentication section of our documentation. If you lose your credentials or think they may be compromised, you can always regenerate them by navigating to the App in question’s keys and tokens section from the Projects & Apps section of the developer portal. You can read more about security best practices to ensure you are storing these credentials in a secure place.
In the dashboard, you can see the Project you’ve created and its App. If you don’t have a Project created, you can create a Project in this section. There are helpful documentation links to commonly used resources. You can also reopen the dashboard tour or API demo tool from onboarding.
Projects & Apps
This section provides you with an opportunity to view and edit your Project, or make changes to your App’s settings. You can configure your Project or Apps, and click on your Apps to obtain your keys and tokens or regenerate if needed.
Projects allow you to organize your work around a use case and manage your access to the Twitter API. You can only add the v2 endpoints. If you have previously created Apps, they will be visible in the section entitled “Standalone Apps”. You can have up to 10 Apps in total including those connected to a Project.
The Products section allows you to learn more about different endpoints and features available. In this section, you can configure access to the Twitter API, Labs, and premium endpoints.
In the Twitter API section, you will see a list of available v2 endpoints and learn more about the details of features, caps, and limits. If you click on an endpoint you will be taken to a page that will show you key usage information and other documentation that can be helpful for you as you build with the API, such as quick start guides and migration guides. Access to v2 endpoints is available for any Project you create.
With Twitter Developer Labs you can experiment with our newest endpoints and give us feedback to help shape the development process. In this section, you can learn more about the endpoints in Labs, explore docs, and connect an App to use them.
In the premium section, you can access our premium products which include the paid and free sandbox versions of the Account Activity API, Search Tweets, and Full Archive Search. You can start with the free sandbox version and upgrade to paid tiers of each product different endpoints and features available
In the account section, you can configure your billing information for premium. If you indicated that you serve government customers when you created your developer account, you can see specific usage information about your account in the subheading entitled “use case information”.
Twitter API demo
Twitter API demo allows you to generate an example request and see the response content for a few different types of Tweets. You can access the Twitter API demo from the dashboard or as part of the new account onboarding process. With the Twitter API demo, we provide an example curl request to show you what the response will look like. You will need to select the Tweet you want to query for the request and response sections will auto-populate based on your selection.
To use this tool, follow the steps below:
Select the sample Tweet you want to learn more about.
Take a look at the expected payload.
You can further by copying the example request and pasting it into your terminal. In your terminal, replace <BEARER TOKEN> with your own bearer token. Once you make the request, you can compare the response that you receive with the one listed in the helper tool.
- Read more about the developer portal.
- Learn more about Apps.
- Learn more about Projects.
- Learn more about authentication.
- Have questions? Check out our FAQ.