Developer Support

Twitter Developer Labs


Twitter Developer Labs lets you experiment with and shape the future of the Twitter Developer Platform.

  • General
  • FAQs

Getting started

Getting started

With Twitter Developer Labs you can test new API previews, provide feedback, and get the latest news on what we're building.

Join Twitter Developer Labs and find out more.

You will need a developer account to use Labs. Apply now to get started.

Errors & troubleshooting

Errors & troubleshooting

You can review the Twitter Developer Labs error codes and troubleshooting page, where we have additional details on why you received an error. 

Get help

Get help

We use the Twitter community forum to field questions relating to Twitter Developer Labs. This is a discussions forum where you will find questions by other developers and technical information on different topics related to Twitter Developer Labs.

We encourage you to join the conversation by responding to questions and engaging in conversations on our forum. Twitter employees are also there to provide support.

Before posting a new question, please review the guidelines below.

Before you post your question

  • Search the community forum for similar questions by other developers

  • Review the community forum guidelines

  • If your inquiry is more of a product suggestion than a technical question, consider posting to our feedback channel

When you post your question, make sure to include the following information

  • A description of the problem

  • The product and the version number that you’re referencing

  • The Twitter response returned (include any error messages)

  • What you expected to receive instead

  • List of steps taken to troubleshoot the issue

  • List of steps required to reproduce the issue

  • If relevant, the time frame during which an issue occurred 

  • Any relevant code sample or screenshots

General Labs technical FAQs

Each endpoint section of the documentation on Twitter Developer Labs also contains its own endpoint-specific FAQ page.

What is Twitter Developer Labs?

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?

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?

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?

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?

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:

  1. Review our error codes page, where we have additional details on why you received that message. 
  2. Review our FAQ pages which live in each endpoint section of our docs. 
  3. Review the rest of the documentation on the endpoint that you are having difficulties with. 
  4. Search our forums to see if someone else in the community has had a similar issue.
  5. 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?

Where can I leave feedback or request functionality related to the Labs endpoints?

Feedback is an important part of why we launched Labs. We are actively seeking feedback from all Labs participants through this survey or our feedback channel.

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?

Do you have any code examples?

We put together a labs-sample-code repo on our @TwitterDev GitHub account

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?

What is the OpenAPI specification, and why should I care?

The OpenAPI specification is an open standard that we are using 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?

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:

Twitter OAuth 1.0a can be tricky to use. We recommend using a tool such as twurlPostman 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?

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?

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.