Interested in exploring Labs?
The endpoints we release in Labs are previews of tools that may be released more broadly in the future, but will likely undergo changes before then. We encourage you to take that into consideration as you explore. Before getting started, please read more about Twitter Developer Labs.
General Labs technical FAQs
What is Twitter Developer Labs?
We have outlined a list of non-technical FAQs on the "About Labs" page that describes the Twitter Developer Labs program.
Should I build my production level application on Labs endpoints?
Please do not build production level applications on Labs endpoints. The endpoints we release in Labs are previews of tools that may be released more broadly in the future, but will likely undergo changes before then. We encourage you to take that into consideration as you explore. Before getting started, please read more about Twitter Developer Labs.
How will Labs endpoints change?
As we gather feedback and iterate on this API, we expect future versions to provide additional features. We would also appreciate feedback on new features introduced in Labs through our feedback channel.
How many versions exist?
There is now a v1 and v2 of Labs, indicated by the route. The current version of Labs will always be highlighted in the documentation, however you can still reference the previous version if needed.. For more details, check the migration guide or our Labs changelog.
Where should I go if I’m experiencing an error or something unexpected with a Labs endpoints?
If you are running into issues, please follow these steps:
- Review our error codes page, where we have additional details on why you received that message.
- Review our FAQ pages which live in each endpoint section of our docs.
- Review the rest of the documentation on the endpoint that you are having difficulties with.
- Search our forums to see if someone else in the community has had a similar issue.
- Submit a new topic to the forums if you can’t find a solution there.
Where can I leave feedback or request functionality related to the Labs endpoints?
Specifically, we are interested in hearing your feature requests, and your positive and negative experiences with the endpoints, data formats, or general usefulness.
The Twitter Developer Labs team will be looking at your input for future iterations of Labs releases and the overall developer platform.
Do you have any code examples?
In addition to this, we have added a Run in Postman button to our "API reference" and "Quick start" pages. You can also download this API specification an upload it to other REST clients such as Insomnia if you prefer.
What is the OpenAPI specification, and why should I care?
The OpenAPI specification is an open standard that we are using it to define the Twitter APIs. It’s useful for both humans and computers to discover what’s available in the API without needing to access it. It also defines what’s available in every API in Labs.
How do I authorize my request?
You will need an approved Twitter developer account, an activated Tweets and Users preview within the Labs portal, and a Twitter developer app assigned to that preview for you to be able to authorize a request to these endpoints.
You can access the endpoints using the following methods:
- OAuth 1.0a User Context - This method requires your Twitter developer app’s consumer key and secret, a set of generated access tokens, and a HMAC-SHA1 signature to make a successful request.
- OAuth 2.0 Bearer Token - This method requires a bearer token to make a successful request.
Twitter OAuth 1.0a can be tricky to use. We recommend using a tool such as twurl, Postman or Insomnia, or an OAuth 1.0a auth library to help auto-generate the signature required for a successful request.
Can I use twurl to make requests to these endpoints?
Yes! Twurl is a great tool for making requests to Twitter APIs. We have included some example twurl requests in our API reference pages.
Do you have any guides for beginners?
Yes! Please review our “Quick start” guides within our products section. We also recommend that beginners use Postman or Insomnia, two REST API development environments to explore the APIs before writing code. We have written a tutorial on how to get started with Postman to help you make your first request.