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.

Labs Changelog

This page tracks recent changes to Twitter Developer Labs platform. Please check back here for updates and other Labs changes.

If you are interested in seeing some of the future launches and updates that we are currently working towards, please review our developer platform roadmap.

May 28, 2020

Defining organic and promoted metrics groupings for Tweet and media objects

We are adding organic_metrics and promoted_metrics to the Tweet and media objects in the Tweet lookup endpoints.

 

May 6, 2020

Metrics in Tweets and recent search endpoints

We are adding metrics to the Tweet and media objects in the GET /tweets and recent search endpoints. 

You can read more about these changes in our forum announcement.

 

April 29, 2020

COVID-19 Stream and Compliance endpoints

Today we are launching a new COVID-19 stream endpoint and an accompanying compliance endpoint.

You can read more about these changes in our forum announcement.

 

March 23, 2020

Tweet annotations in Tweets and recent search endpoints

We are adding annotations to the Tweet object in the Tweets and recent search endpoints.

You can read more about this change in our forum announcement.

 

February 26, 2020

Introducting the hide replies endpoint

We want to help people feel safe and comfortable having conversations on Twitter. As part of that, today we’re excited to give Tweet authors more control over the conversations they start by supporting the hide replies feature with a new endpoint.

You can read more about this new endpoint in our forum announcement.

 

February 25, 2020

v2 of Labs endpoints: Tweets and Users, Recent Search, Hide Replies

Today, we are bringing our Tweets and Users, Recent Search and Hide Replies endpoints to v2 of Labs. We are deprecating Labs v1 endpoints and will fully retire them 90 days after this initial release. We will also keep our v1 documentation available for this duration. You can provide us feedback on this versioning strategy via our feedback channel

We're releasing the following changes to Tweets and Users:

  • Introduce fields as a query parameter
  • Remove formats as a query parameter
  • Add path variable for single ID lookup in Tweets and Users
  • Adjusting the path and query parameters for single and multi-username lookup in GET /users
  • Change field name stats to public_metrics

Other changes include:

  • Remove the most_recent_tweet_id expansion in Users
  • Remove HTML tags from the source field in Tweets to make that field easier to parse

The core search, pagination and other functionality of Recent Search will stay the same.

We have put together some migration materials for when you update from v1 to v2.

You can read more about this change in our forum announcement.

 

January 21, 2020

Hiding access tokens and access token secrets

Today, we're making changes to the way that Access Tokens and Access Token Secrets are presented and managed within the applications Dashboard on developer.twitter.com

In order to make API integrations more secure, we will no longer show the Access Token and Access Token Secret on the Dashboard beyond the first time that these values are generated.

After the first time, these credentials can not be retrieved. You will be able to regenerate the tokens on the Dashboard, but this will invalidate your current token and secret.

You can read more about this change in our forum announcement.

 

January 6, 2020

New Recent search endpoint available in Labs

Today, we are releasing a new endpoint to search for Tweets posted in the last 7 days

Learn more about this launch via our forum announcement.

 

December 10th, 2019

Tweet annotations added to the Tweet Object for sampled stream and filtered stream endpoints in Labs

Today in Twitter Developer Labs, we are releasing new metadata elements to the default Tweet payload. These new fields, rendered as part of the Tweet payload, will provide more contextual information about the Tweet.

Learn more about this launch via our forum announcement.

 

October 22nd, 2019

New sampled stream endpoint available in Labs

Today, we are releasing a new endpoint to stream a sample of all public Tweets in real-time, as they are posted. 

Learn more about this launch via our forum announcement.

 

September 18th, 2019

New filtered stream endpoint available in Labs

Today, we are releasing a new streaming endpoint to retrieve Tweets, and an endpoint to manage your filters in Twitter Developer Labs. With these endpoints, you will be able to retrieve up to 500,000 Tweets per month (maximum 50 Tweets per second); you can set up to 10 filter rules on your stream (these can be applied at the same time).

Learn more about this launch via our forum announcement.

Documentation: improvements to request parameters

Requests parameters documented in the API reference pages are now clearly marked as either optional or required. Additionally, API reference pages will describe a JSON body payload when this is allowed by a request.

 

August 27th, 2019

New Tweet metrics are now available in Labs

You can now retrieve engagement data for any Tweet or list of Tweets from owned/authorized accounts. The Tweets you query must be no older than 30 days and cannot be Retweets.

GET /tweets/metrics/private supports the following metrics:

  • impressions
  • Retweets
  • Quote Tweets
  • likes
  • replies
  • video views
  • video view quartiles (where the requester is also the author of the media)


Learn more about this launch via our forum announcement.

 

August 12th, 2019

New expansion for GET /users: pinned Tweet in Twitter Developer Labs

  • pinned_tweet_id will expand a user’s pinned Tweet through our user object expansion.

 

July 31st, 2019

New metadata available for Quote Tweet counts:

  • Developers can use the new Labs endpoints to pull counts of Quote Tweets.

New expansion for GET /users: most recent Tweet

  • most_recent_tweet_id will expand a user’s most recent Tweet through our user object expansion.

Learn more about this launch via our forum announcement.

 

June 20th, 2019

New expansions for GET /tweets: referenced author and mentioned user

We added two new expansions to the GET /tweets endpoint:

  • entities.mentions.username will expand the username of any recognized user mention in a Tweet into a full user object.
  • referenced_tweets.id.author_id expands the ID of the author of any referenced Tweet, when one of the Tweets requested is a Retweet, Quoted Tweet or Reply. This expansion will also expand the referenced Tweet ID into a full object.

 

Documentation Added code samples for JavaScript (Node.js)

The Quick Start guides have been updated with a new code sample to show how to make requests in a Node.js environment. 

 

June 11th, 2019

GET /tweets and GET /users are now supported in Labs

The first two endpoints are now available via the Labs portal. Make sure you have an approved developer account and have applied for Labs access to get started with these endpoints.

Key differences from equivalent v1.1 functionality include:

  • Single endpoint for single object "show" function and batch "lookups"
  • Expansion parameters support the inclusion of additional objects as part of one request (e.g. mentioned users, referenced Tweets, etc.)
  • Format parameters support different data projections with more or less verbose payloads
  • Rate limiting is at the app level, regardless of auth method (user context or bearer token)

Learn more about this launch via our forum announcement.