Changelog
The Twitter Developer Platform is updated frequently with new functionality and products to better suit your needs. We will be documenting all changes made to the platform’s products via this resource and @twitterapi.
To subscribe to updates, please “Turn on notifications” for @twitterapi.
- Historical changelog
April 22nd, 2021
Manage Likes available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new manage Likes endpoints to the Twitter API v2. These endpoints enable you to use the v2 API to like and unlike Tweets.
To learn more about this launch, please visit our forum announcement
April 7th, 2021
Manage blocks available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new manage blocks endpoints to the Twitter API v2. These endpoints enable you to block or unblock accounts on behalf of a user using user IDs.
To learn more about this launch, please visit our forum announcement.
March 3rd, 2021
Removing support for Embedded Like, Collection, and Moment Timelines
Twitter for Websites
Today we’re sharing our plans for the future of embedded timeline widgets. On June 23rd 2021, we plan to retire the Likes, Collections, and Moments timelines. We recommended you use the Profile and Lists timelines, which we’re updating to become faster, easier to use, and more up-to-date with Twitter features and functionality.
You can learn more about this change in our forum announcement.
February 10th, 2021
Manage follows available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new manage follows endpoints to the Twitter API v2. These endpoints enable you to follow or unfollow accounts on behalf of a user using their user ID. This launch comes just a few months after the launch of the follows lookup endpoints, which allow you to retrieve an account’s followers and who they are following.
To learn more about this launch, please visit our forum announcement.
January 26th, 2021
Introducing the Twitter API v2 Academic Research product track
Twitter API v2: Early Access
Today, we are introducing the new Academic Research product track to Twitter API v2. This update introduces a new application process for Academic Researchers that will provide those that are approved with an Academic Research Project that will unlock greater access and advanced functionality.
With the new Academic Research product track, you will be able to access the following:
- The new Twitter API v2 full-archive search endpoint, which is only available to the Academic Research product track at this time.
- An increased Tweet cap of 10 million, up from the 500,000 that is available to the Standard product track at the Basic access level.
- New filter operators available to recent search, full-archive search, and filtered stream, including
$
(aka cashtag),bio
(only available via filtered stream),bio_name
(only available via filtered stream),bio_location
(only available via filtered stream),place
,place_country
,point_radius
,bounding_box
,-is:nullcast
,has:cashtags
andhas:geo
. - An increased rule limit for filtered stream of 1,000 concurrent rules, up from the 25 that is available to the Standard product track at the Basic access level.
- An increased query and rule character limit of 1,024 characters long, up from the 512 character limit that is available to the Standard product tack at the Basic access level
To learn more about this launch, please visit our forum announcement.
December 18th, 2020
Conversation reply settings Tweet field for v2 Twitter API
Twitter API v2: Early Access
Today we are launching a new field in the Tweet object called reply_settings. This field is available on all Twitter API v2 endpoints that return Tweets including Tweet lookup, hide replies, recent search, sampled stream, filtered stream, follows lookup, user Tweet timeline, and user mention timeline endpoints or by expanding the Tweet object in any endpoint.
This field indicates how the Tweet author has allowed others to reply to their Tweets, whether it’s everyone, just the people they mention in the Tweet, or those they follow. The field values returned by the reply_settings
field include everyone
, mentionedUsers
, and following
. If no conversation controls are set for the Tweet, this will still show up in the Tweet object with everyone
value for the field.
December 17th, 2020
User Tweet timeline and user mention timeline available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new user Tweet timeline and user mention timeline endpoints to the Twitter API v2. These endpoints enable you to request the Tweets composed by, or mentioning, a specified account on Twitter. Learn more in the forum post announcement.
December 17th, 2020
Follows lookup available in the Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new follows lookup endpoints to the Twitter API v2. These endpoints enable you to retrieve an account’s followers and who they are following using their user ID. Learn more in the forum post announcement.
November 16th, 2020
Retiring some Labs v2 endpoints
Twitter Developer Labs
Retired Labs v2 recent search and hide replies endpoints
We have retired the following endpoints. If you were using the Labs versions of these endpoints, you can use the linked migration guides to update your integration to start using the new Twitter API v2 versions:
We also have additional details about migration to the new Twitter API v2 via our migration hub.
If you have any questions, please reach out to our Labs forum category.
October 12th, 2020
Retiring some Labs v1 endpoints
Twitter Developer Labs
On August 12th, 2020, we launched the new Twitter API v2: Early access. With this release, we graduated several endpoints to Twitter API v2 from the Labs program, and announced that the Labs version of the endpoints would remain in a deprecated state for 60 days before retiring them.
Today marks 60 days since the launch, meaning that we have retired the following endpoints. If you are using the Labs versions of these endpoints, you can use the linked migration guides to update your integration to start using the new Twitter API v2 versions:
We also have additional details about migration to the new Twitter API v2 via our migration hub.
If you have any questions, please reach out to our Labs forum category.
September 3rd, 2020
Tweet consumption status bar added to the new developer portal experience
Developer Portal Twitter API v2: Early Access
In the main dashboard page of the new developer portal, you can now check your usage towards the Tweet cap of 500,000 Tweets per month. This cap is applied at the Project level, across the following v2 endpoints in Basic access: filtered stream, and recent search.
In order to see this feature and use the new v2 endpoints, you will need to activate the new developer portal experience.
August 19th, 2020
Hide replies available in v2 Twitter API
Twitter API v2: Early Access Twitter Developer Labs
Today, we’re launching the new hide replies endpoint into the v2 Twitter API. This endpoint enables you to hide abusive, distracting, or misleading replies to Tweets – a crucial piece to improving the health of the public conversation. Learn more in the forum post announcement.
The same endpoint in Twitter Developer Labs is now deprecated, and it will be retired in 90 days. Learn how to migrate to the v2 endpoint.
August 12th, 2020
Twitter API v2: Early Access released
Twitter API v2: Early Access
Today we announced Early Access to the first endpoints of the new Twitter API!
The new Twitter API features a new API foundation which will allow us to deliver new functionality faster; an updated data format and new functionality that gives you more control over which fields you receive; new Tweet, user, and media fields; and a set of updated endpoints that enable you to listen to and analyze Tweets, including the following:
You can find a full list of the new functionality available, and find migration resources on our Twitter API v2: Early Access docs page.
Learn more about what we have planned in our “Guide to the future of the Twitter API”.
Deprecating certain Labs endpoints
Twitter Developer Labs
We are deprecating certain Labs endpoints due to the launch of their Twitter API v2 replacements in this release.
The following Labs v1 endpoints will be retired 60 days from today's release:
- Tweet metrics v1
- Filtered stream v1
- Sampled stream v1
The following Labs v2 endpoint will be retired 90 days from today’s release:
- Recent search v2
July 13th, 2020
Improvements to Hide replies
Twitter Developer Labs
We added the ability to unhide a reply. Additionally, previously unhidden replies can now be hidden again via this endpoint.
Get more details in the Hide replies documentation.
July 8th, 2020
Retiring certain Labs v1 endpoints
Twitter Developer Labs
Today we are retiring the Labs v1 Tweets and users, hide replies, and recent search endpoints.
You can read more about our Labs v1 plan in our forum announcement.
July 7th, 2020
Quote Tweets available for the /totals endpoint
Twitter API: Enterprise v1.1
Today, the quote_tweets
metric is now available for 'unowned' Tweets via the /totals endpoint. This means that you can access the Quote Tweet count for all Tweets by using app-only authentication.
You can read more about this change in our forum post.
July 1st, 2020
Adding two new Tweets metrics
Twitter Developer Labs
Today we are adding two new non-public metrics subfields, user_profile_clicks
and url_link_clicks
, to the Tweet object in the Twitter Developer Labs Tweet lookup endpoints. They will be returned when using the tweet.fields
parameter with any of the following values: non_public_metrics
, organic_metrics
, or promoted_metrics
.
To learn more, please visit the Tweet lookup API reference
June 15th, 2020
Changes to Twitter web, iOS and Android Retweet counts
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Starting today, Twitter web, iOS and Android will be showing the total 'Retweets and comments' count per Tweet. Using the Twitter API, the total 'Retweets and comments' number matching the Twitter interface can be calculated by adding the retweet_count
and quote_count
when available. Additionally quote_count
will be the total unique accounts that have quoted the Tweet, rather than the total Tweets quoting the Tweet. For more details, please see our forum post.
May 28th, 2020
Defining organic and promoted metrics groupings for Tweet and media objects
Twitter Developer Labs
We are adding organic_metrics
and promoted_metrics
to the Tweet and media objects in the Tweet lookup endpoints.
May 6th, 2020
Metrics in Tweets and recent search endpoints
Twitter Developer Labs
We are adding metrics to the Tweet and media objects in the Tweet lookup and recent search endpoints.
You can read more about these changes in our forum announcement
April 29th, 2020
COVID-19 Stream and Compliance endpoints
Twitter Developer Labs
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 31st, 2020
PowerTrack's Replay API now delivers current user profile data
Twitter API: Enterprise v1.1
Starting today, the Replay API will deliver user profile objects that reflect the referenced user at the time the Replay API is running. This change to deliver current user profile objects is similar to the recent Historical PowerTrack update below from Nov. 25, 2019.
March 23rd, 2020
Tweet annotations in Tweets and recent search endpoints
Twitter Developer Labs
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.
March 10th, 2020
Major updates to the Twitter Developer Policy
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today, we announced a significant update to the Developer Policy. We encourage you to read more about this via our forum and blog posts, and to review the revised policy. The Developer Policy is one of the foundations for your use of the Twitter API and it is important to understand your commitments.
February 26th, 2020
Introducting the hide replies endpoint
Twitter Developer Labs
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 25th, 2020
v2 of Labs endpoints: Tweets and Users, Recent Search, Hide Replies
Twitter Developer Labs
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
topublic_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.
February 7th, 2020
Twitter API: Enterprise v1.1
Today we added new drop/undrop event types to the Compliance Firehose API. You can read more about them in our documentation.
January 21st, 2020
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
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 15th, 2020
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Starting January 15, 2020, all connections to the Twitter API (and all other Twitter domains) will no longer support SPDY connections.
You can read more about this change in our forum announcement.
January 6th, 2020
New Recent search endpoint available in Labs
Twitter Developer 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 29th, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
A new updated major release of our Twitter API CLI, twurl
, is now available. This release includes a number of bug fixes and enhancements and introduces Bearer Token support which helps to add functionality around the Premium and Twitter Developer Labs endpoints. Read more in our forum post.
December 10th, 2019
Tweet annotations added to the Tweet Object for sampled stream and filtered stream endpoints in Labs
Twitter Developer 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.
November 25th, 2019
Twitter API: Enterprise v1.1
Today, we’re updating our "batch historical Tweets" endpoint (Historical PowerTrack) to provide user profile location, bio description, and display name information that reflects values in place at the of the job processing. When the updated user objects are delivered, there will be a new "updated" string array in the User/Actor object.
There are up to three possible values: name, description, location:
"updated": ["name", "description", "location"]
See the documentation on Historical PowerTrack's data format for more details.
October 29th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we’re releasing a new feature to the Account Activity API that will provide developers with the ability to view whether an account that mentions your subscribed user is blocked.
You can read more about the user_has_blocked data object structure and check out our forum announcement for more details.
October 22nd, 2019
New sampled stream endpoint available in Labs
Twitter Developer 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
Twitter Developer 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
Twitter Developer 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 15th, 2019
Twitter API: Standard v1.1
Starting today, applications that need to create Direct Messages will be required to have "Read, Write, and Direct Messages" app permissions (RW+DM). Applications attempting to create Direct Messages with only the RW app permission will receive the following error:
{"code": 93,"message": "This application is not allowed to access or delete your direct messages."}
You can learn more about this change via our forum announcement.
August 12th, 2019
New expansion for GET /users: pinned Tweet in Twitter Developer Labs
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:
Twitter Developer Labs
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.
July 25th, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Ads API Twitter Developer Labs
Today, all connections to the Twitter API (and all other Twitter domains) will require TLS 1.2.
You can read more about this change in our forum announcement.
July 15th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Starting today, we are introducing the new Account Activity API endpoint to deactivate user subscriptions using application-only OAuth.
This new endpoint offers developers the convenience of only having to provide a bearer token to deactivate a subscription, without requiring the subscribed user’s access token.
We are immediately marking the existing enterprise Account Activity API endpoint used to deactivate user subscriptions with 3-Legged OAuth as deprecated. The endpoint will be retired and no longer be available starting from January 15, 2020.
Developers can learn more about this API in our documentation.
June 20th, 2019
New expansions for GET /tweets: referenced author and mentioned user
Twitter Developer Labs
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.
June 11th, 2019
GET /tweets and GET /users are now supported in Labs
Twitter Developer 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.
June 10th, 2019
Twitter API: Standard v1.1
We have fully retired the Terms of Service and Privacy Endpoints. The current status of our Privacy Policy and Terms of Service is best served by our up-to-date web pages.
You can learn more about this change via our forum announcement.
May 21st, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today some user object fields, including user.lang, will start returning 'null' for updated metadata fields previously announced in our forum post.
Developers can learn about this change through our documentation.
May 20th, 2019
Twitter API: Enterprise v1.1
Starting today, we are introducing the Account Activity Replay API, a data recovery tool available with the enterprise tier of the Account Activity API
The Account Activity Replay API allows you to retrieve events from as far back as five days. It should be utilized to recover data in scenarios where your webhook server misses events
Developers can learn more about this API in our documentation.
May 6th, 2019
Twitter API: Enterprise v1.1
Starting today, native media (photos, videos, and GIFs) can be added to Quote Tweets on Twitter, which will be shown as additional media metadata in the entities sections of Quote Tweet payloads.
Developers can learn more about this in our documentation.
February 13th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, the operator is:reply becomes available to use with the enterprise search APIs and the paid version of the premium search endpoints.
The is:reply Boolean operator can be used to filter all replies to Tweets, or to filter out explicit replies that match a rule. This operator functions in the same way as the is:quote operator.
Remember that, with the Search API, all ‘is:’ and ‘has:’ operators must be used in conjunction with a standalone operator like a keyword or hashtag.
You can learn more about this operator in the documentation.
February 6th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Starting today, the expanded URL enrichment will no longer contain the unwound URL object and metadata (including the title and description fields) for URLs linking to Tweets, Moments, or profiles. Please note that other URLs (to websites, etc.) will continue to be enriched with this metadata, and the url, expanded_url, and display_url
will still be available. This change applies to Decahose, PowerTrack, Historical PowerTrack, and the Search APIs.
November 29th, 2018
Twitter API: Enterprise v1.1
Today, we are introducing a new operator, is:reply, to help you narrow conversations to those you care about most. You can now filter out replies from your results (in addition to the pre-existing ability to filter out Retweets, is:retweet, and Quoted Tweets, is:quote). This new operator is available today within PowerTrack, Historical PowerTrack, and Replay.
The is:reply Boolean operator can be used to filter all replies to Tweets, or to filter out explicit replies that match a rule. This operator functions in the same way as the is:quote operator.
You can learn more about this operator in the documentation.
November 19th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Ads API Twitter Developer Labs
Today, we've added the ability for developers to view and edit their existing Twitter apps via the Twitter app dashboard on developer.twitter.com as long as they're logged into their Twitter account. Previously, you could only view and edit your existing Twitter apps on developer.twitter.com if you had applied or been approved for a developer account.
You still must have an approved developer account to be able to create new Twitter apps.
November 7th, 2018
Twitter API: Standard v1.1 Twitter Ads API
Today, we are announcing that advertisers and publishers are now able to add subtitle files (SRT) to their videos via ads.twitter.com, Media Studio and our publisher upload API. Subtitles will be viewable on auto-playing video (when no sound is available) on Android and Web. We will release the functionality for iOS in the coming weeks.
To read more about the new subtitles endpoints, please review their respective API reference pages:
November 5th, 2018
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today we are announcing an update to the Account Activity API endpoint, GET subscriptions/count. To enable greater visibility into your billing details and use of the API, beginning today, you can programmatically pull the number of provisioned subscriptions associated with your Account Activity API instance within the JSON. This means you can now see both what your provisioned number of subscriptions are, and how close you are to hitting that limit via the GET subscriptions/count API endpoint.
This update has been documented with the Account Activity API documentation.
October 22nd, 2018
Twitter API: Standard v1.1
Today we are implementing new app-level rate limits on several of our standard POST endpoints:
- POST statuses/update
- POST statuses/retweet/:id
- POST favorites/create
- POST direct_messages/events/new
- POST friendships/create
You can read more about this change in our forum announcement.
October 10th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Today we are announcing an update to the twitter-text library to account for the recent changes to the way that Twitter counts emojis. If an emoji previously counted as more than two characters, its count will now be reduced to just two characters to allow for users to make the most out of their 280 characters.
You can read more about this change in our forum announcement.
September 17th, 2018
Twitter API: Standard v1.1
We have fully retired the legacy Direct Message endpoints. You can find a list of the retired DM endpoints, as well as their replacements on this page.
You can learn more about this update via our forum announcement.
September 11th, 2018
Twitter API: Standard v1.1
Today we are implementing some changes to the process where you retreive attached media from Direct Messages. We will no longer support accessing media_url
or media_url_https
via an authenticated www.twitter.com session. The request to fetch media_url_https
MUST always be signed with the user’s access token using OAuth 1.0A.
You can learn more about this update via our forum announcement.
August 23rd, 2018
Twitter API: Enterprise v1.1
We have fully retired User Streams and Site Streams.
You can learn more about this update via our forum announcement.
August 20th, 2018
Twitter API: Enterprise v1.1
Today we are launching a new version of the Usage API. With this update, we’re making the API more stable by moving to a new system.
With the system update, users will experience a data "hole" as developers will only be able to pull data back to May 1, 2018. Therefore for the upcoming year, they will be missing out on a few months of historical data (until June 2019).
A product name is changing within the Usage API from Historical PowerTrack Subscription to Historical PowerTrack 2.0 which will make the product naming consistent with the rest of our user-facing wording. Customers will receive the exact same data in the same format with the update. You will see this change within the products.type JSON object.
If you have any questions, please reach out to your account manager.
August 16th, 2018
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1
The Account Activity API DM Beta product was fully retired today.
The following services and endpoints will experience degraded service starting today:
- User Streams
- Site Streams
- GET direct_messages
- GET direct_messages/sent
- GET direct_messages/show
- POST direct_messages/new
- POST direct_messages/destroy
User Streams and Site Streams will be fully retired on August 23rd.
The legacy Direct Messages endpoints will be fully retired on September 17th.
You can learn more about this update via our forum announcement.
July 24th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
As of today, you will no longer be able to create new Twitter apps via apps.twitter.com. You will now be redirected to either your developer portal account or, if you don't have a developer portal account yet, to the page where you can apply.
We also announced that we will be implementing new app-level rate limits to the following POST endpoints on September 10th, 2018.
- POST statuses/update
- POST statuses/retweet:id
- POST friendships/create
- POST favorites/create
- POST direct_messages/events/new
Finally, we are introducing a new option for people to report suspected violations of our platform policies to you for review.
You can learn more about all of these updates via our blog post.
June 21st, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
If you have a developer portal account, you can now create and manage your Twitter apps. Please read our forum post for more details.
June 12th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Today, we started requiring that you register the callback URLs that you use with the Sign in with Twitter process. You can read more about this update here.
We also announced the addition of the tweet_delete_events activity to the Account Activity API. This new activity will be sent for those corresponding deleted events to enable developers to more easily provide a compliant experience for their customers and application users. You can read more about this new activity in our forum post or on our documentation.
May 25th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today, we made some changes to our Terms of Service, Privacy Policy, and Twitter Developer Agreement that include privacy, security, and data protection updates. Please read our forum post for more details.
May 23rd, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
Today, the timezone values in Twitter user objects became private fields. From here on out, all* time_zone and utc_offset data objects will return as null. Please read our forum post for more details.
* They will continue to be available on the account/settings endpoint, for authenticated users only.
May 21st, 2018
Twitter API: Enterprise v1.1
Today, we removed all Klout data from Tweet payloads as part of our GDPR updates.
May 14th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we are changing all instances of profile_background_image_url and profile_background_image_url_https to their default values. Please read our forum post for more details.
In addition to the above change, we are adding a new field to the Account Activity API payloads to reference which subscription the activity was delivered for. This JSON object is called for_user_id and will include the subscribed user's ID who produced that activity as its value. You can see some examples of this new JSON object in our account activity objects page.
May 10th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we are announcing a change to the way that URLs will be rendered in the Quote Tweet payload.
We’re adding a new entity called the "quoted_status_permalink" entity to ensure the quoted Tweet can be referenced and we will be removing the t.co link from the quoted Tweet "text" field.
With the new format, the t.co link is no longer appended to the "text" field of the quoted Tweet in the "quoted_status" object.
Further, we will no longer put the quoted Tweet t.co url, expanded_url, and display_url in the ‘urls’ entity. Instead, these will be added to a new "quoted_status_permalink" object with "url", "expanded", and "display" URL attributes. This means that the "quoted_status_permalink" object will be reserved for the t.co link back to the quoted Tweet, whereas the "entities.urls" array can be used to identify any links shared within the original Tweet or Quote Tweet.
Please read our forum post and updated documentation for more details.
April 30th, 2018
Twitter for Websites
The announcement of Twitter Kit deprecation, after October 31, 2018 Twitter Kit will no longer be actively maintained. Please read our blog post for more details.
April 24th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today we announced several updates to the platform related to GDPR. Please read our forum post for more details.
March 1, 2018
Twitter API: Enterprise v1.1
The addition of a new object to the Tweet payload – additional_media_info object – and also restricting some video details (video_info) for promoted Tweets where advertisers have requested we limit video playback to Twitter owned clients. You can find additional information about this change at the following link: Extended Entities Objects > Tweet with native video.
February 1st, 2018
Twitter API: Premium v1.1
Launch of the premium full-archive search endpoint.
December 19th, 2017
Twitter API: Premium v1.1
Launched both (All Activities) and (Direct Messages) Standard beta Account Activity APIs, read more about this launch on our blog. Announced User streams & Site streams deprecation and sunset date of Tuesday June 19, 2018.
December 15th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Version 2.0 of twitter-text is now available on GitHub. This update addresses the change in our character limit that was rolled out on November 7th, 2017. To learn more about this update, please visit our forum.
November 14th, 2017
Twitter API: Premium v1.1
Launched the Premium APIs.
These new APIs build on the quality and stability of our enterprise data platform, and make it available more widely via a tiered pricing model. For the first time, you can start to search across 30 days of Tweets (instead of the limited 7 days of data on the standard endpoint), and optionally, you can also access our premium enrichments for profile geo, URL expansion, and poll data. Here’s a taste of some of the new features:
- More Tweets per request (Sandbox + Premium)
- A far more rich query language enabling more complex queries (Sandbox + Premium)
- A counts endpoint that returns time-series counts of Tweets (Premium)
- Metadata enrichments, such as expanded URLs and Profile Geo (Premium)
Read more about this launch on our blog.
November 7th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Official launch of 280 character Tweets in languages where cramming was an issue. Please see our forum announcement or official blog post for further reference.
November 1st, 2017
Twitter API: Standard v1.1
The ability to send Direct Messages via the statuses/update API endpoint has been completely removed, and the enable_dm_commands
and fail_dm_commands
parameters will no longer have any effect. Read more about this update on our forum.
October 11th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
A change was made to Twitter’s backend OAuth API endpoints which altered the behaviour of the /oauth/authenticate endpoint to match that of the /oauth/authorize endpoint. Read more about this update on our forum.
October 10th, 2017
Twitter API: Enterprise v1.1
The Engagement API was updated to use the same metrics aggregation methodology in use by the Twitter analytics dashboard. Read more about this update on our forum.
October 1st, 2017
Twitter API: Standard v1.1
The default value of the fail_dm_commands
parameter within the DM statuses/update endpoint has been switched to true. All status updates intended as Direct Messages will start to return errors (unless enable_dm_commands
is false, in which case the Tweet will be posted). Read more about this update on our forum.
September 26th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
The response payload for 280 character tweets will be treated the same way as long tweets. Read more about this update on our forum.
September 11th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Adding new data to the Tweet payload (additional_media_info object
) and also restricting some video details (video_info
) for promoted Tweets where advertisers have requested we limit video playback to Twitter owned clients. You can find additional information about this change at the following link: Extended Entities Objects > Tweet with native video
August 7, 2017
Twitter API: Enterprise v1.1
30-Day and Full-Archive Search ended support for url_contains: operator. Deprecation of this operator was announced as part of the Gnip 2.0 migration in August 2016. Any Search query using the url_contains: Operator will be rejected as invalid.
July 6, 2017
Twitter API: Enterprise v1.1
The enterprise Search API (both 30-Day and Full-Archive) will no longer support the url_contains: operator beginning 30 days from today, or after August 4, 2017 (Support of url_contains: will actually end with the first deploy after that date). Deprecation of this operator was announced as part of the Gnip 2.0 migration in August 2016. When Operator support is ended, any query using the url_contains: will be rejected as invalid.
June 2nd, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
The xAuth authentication mechanism has been removed from all Twitter APIs Read more about this update on our forum.
May 8th, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
All HTTP headers have been forced into lowercase (content-type
, x-rate-limit-remaining
, x-access-level
etc). Read more about this update on our forum.
May 5th, 2017
Twitter API: Standard v1.1
The optional enable_dm_commands
parameter to statuses/update will enable applications to remove DM command support early, before the transition period ends. The default value is true (i.e. current legacy behavior), but this may be set to false to get the new, post-November 1 behavior. The optional fail_dm_commands parameter to statuses/update will make DM commands return HTTP 403 (error code 151) from the API when set to true. The default value is false. Read more about this update on our forum.
April 25th, 2017
Twitter API: Enterprise v1.1
Rules with emojis are now available in the enterprise Search APIs
April 6th, 2017
Twitter API: Standard v1.1
Access to several new Direct Message APIs are now more widely available. Read more about this update on our blog.
March 9th, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
MPEG-DASH URLs (.mpd) has been removed from the payload of a Tweet that contains video. Read more about this update on our forum.
February 22nd, 2017
Twitter API: Enterprise v1.1
New Enrichment! Poll Metadata is now available through our enterprise APIs. See the documentation for more details.
New payload field: Image Alt-Text (decription) field may be present in the entities.media[] and extended_entities.media[] section of the payload if a user chooses chooses the "Add description" option when adding a photo to a Tweet. This is available in enriched native format only.
Default payload format: Newly created streams on Gnip products will now default to orriginal format JSON.
January 23rd, 2017
Twitter API: Enterprise v1.1
Historical PowerTrack API & Replay API
- Quote Tweet filtering is now supported
- Quoted Tweets are now fully rehydrated within HPT and Replay Tweet payloads
January 17th, 2017
Twitter API: Enterprise v1.1
New payload fields: quote_count and reply_count are now available in native enriched format payloads across Realtime and Historical APIs
December 20th, 2016
Twitter API: Enterprise v1.1
Full-Archive Search API (FAS):
- Added support for additional geo operators:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality:
December 5th, 2016
Twitter API: Enterprise v1.1
Rule management (GET and DELETE) by Rule ID is now available for PowerTrack 2.0 and PowerTrack Replay 2.0
November 10th, 2016
Twitter API: Enterprise v1.1
30-Day Search API:
- Added support for additional geo operators:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality:
March 3rd, 2021
Removing support for Embedded Like, Collection, and Moment Timelines
Twitter for Websites
Today we’re sharing our plans for the future of embedded timeline widgets. On June 23rd 2021, we plan to retire the Likes, Collections, and Moments timelines. We recommended you use the Profile and Lists timelines, which we’re updating to become faster, easier to use, and more up-to-date with Twitter features and functionality.
You can learn more about this change in our forum announcement.
February 10th, 2021
Manage follows available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new manage follows endpoints to the Twitter API v2. These endpoints enable you to follow or unfollow accounts on behalf of a user using their user ID. This launch comes just a few months after the launch of the follows lookup endpoints, which allow you to retrieve an account’s followers and who they are following.
To learn more about this launch, please visit our forum announcement.
January 26th, 2021
Introducing the Twitter API v2 Academic Research product track
Twitter API v2: Early Access
Today, we are introducing the new Academic Research product track to Twitter API v2. This update introduces a new application process for Academic Researchers that will provide those that are approved with an Academic Research Project that will unlock greater access and advanced functionality.
With the new Academic Research product track, you will be able to access the following:
- The new Twitter API v2 full-archive search endpoint, which is only available to the Academic Research product track at this time.
- An increased Tweet cap of 10 million, up from the 500,000 that is available to the Standard product track at the Basic access level.
- New filter operators available to recent search, full-archive search, and filtered stream, including
$
(aka cashtag),bio
(only available via filtered stream),bio_name
(only available via filtered stream),bio_location
(only available via filtered stream),place
,place_country
,point_radius
,bounding_box
,-is:nullcast
,has:cashtags
andhas:geo
. - An increased rule limit for filtered stream of 1,000 concurrent rules, up from the 25 that is available to the Standard product track at the Basic access level.
- An increased query and rule character limit of 1,024 characters long, up from the 512 character limit that is available to the Standard product tack at the Basic access level
To learn more about this launch, please visit our forum announcement.
December 18th, 2020
Conversation reply settings Tweet field for v2 Twitter API
Twitter API v2: Early Access
Today we are launching a new field in the Tweet object called reply_settings. This field is available on all Twitter API v2 endpoints that return Tweets including Tweet lookup, hide replies, recent search, sampled stream, filtered stream, follows lookup, user Tweet timeline, and user mention timeline endpoints or by expanding the Tweet object in any endpoint.
This field indicates how the Tweet author has allowed others to reply to their Tweets, whether it’s everyone, just the people they mention in the Tweet, or those they follow. The field values returned by the reply_settings
field include everyone
, mentionedUsers
, and following
. If no conversation controls are set for the Tweet, this will still show up in the Tweet object with everyone
value for the field.
December 17th, 2020
User Tweet timeline and user mention timeline available in Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new user Tweet timeline and user mention timeline endpoints to the Twitter API v2. These endpoints enable you to request the Tweets composed by, or mentioning, a specified account on Twitter. Learn more in the forum post announcement.
December 17th, 2020
Follows lookup available in the Twitter API v2
Twitter API v2: Early Access
Today, we’re launching the new follows lookup endpoints to the Twitter API v2. These endpoints enable you to retrieve an account’s followers and who they are following using their user ID. Learn more in the forum post announcement.
November 16th, 2020
Retiring some Labs v2 endpoints
Twitter Developer Labs
Retired Labs v2 recent search and hide replies endpoints
We have retired the following endpoints. If you were using the Labs versions of these endpoints, you can use the linked migration guides to update your integration to start using the new Twitter API v2 versions:
We also have additional details about migration to the new Twitter API v2 via our migration hub.
If you have any questions, please reach out to our Labs forum category.
October 12th, 2020
Retiring some Labs v1 endpoints
Twitter Developer Labs
On August 12th, 2020, we launched the new Twitter API v2: Early access. With this release, we graduated several endpoints to Twitter API v2 from the Labs program, and announced that the Labs version of the endpoints would remain in a deprecated state for 60 days before retiring them.
Today marks 60 days since the launch, meaning that we have retired the following endpoints. If you are using the Labs versions of these endpoints, you can use the linked migration guides to update your integration to start using the new Twitter API v2 versions:
We also have additional details about migration to the new Twitter API v2 via our migration hub.
If you have any questions, please reach out to our Labs forum category.
September 3rd, 2020
Tweet consumption status bar added to the new developer portal experience
Developer Portal Twitter API v2: Early Access
In the main dashboard page of the new developer portal, you can now check your usage towards the Tweet cap of 500,000 Tweets per month. This cap is applied at the Project level, across the following v2 endpoints in Basic access: filtered stream, and recent search.
In order to see this feature and use the new v2 endpoints, you will need to activate the new developer portal experience.
August 19th, 2020
Hide replies available in v2 Twitter API
Twitter API v2: Early Access Twitter Developer Labs
Today, we’re launching the new hide replies endpoint into the v2 Twitter API. This endpoint enables you to hide abusive, distracting, or misleading replies to Tweets – a crucial piece to improving the health of the public conversation. Learn more in the forum post announcement.
The same endpoint in Twitter Developer Labs is now deprecated, and it will be retired in 90 days. Learn how to migrate to the v2 endpoint.
August 12th, 2020
Twitter API v2: Early Access released
Twitter API v2: Early Access
Today we announced Early Access to the first endpoints of the new Twitter API!
The new Twitter API features a new API foundation which will allow us to deliver new functionality faster; an updated data format and new functionality that gives you more control over which fields you receive; new Tweet, user, and media fields; and a set of updated endpoints that enable you to listen to and analyze Tweets, including the following:
You can find a full list of the new functionality available, and find migration resources on our Twitter API v2: Early Access docs page.
Learn more about what we have planned in our “Guide to the future of the Twitter API”.
Deprecating certain Labs endpoints
Twitter Developer Labs
We are deprecating certain Labs endpoints due to the launch of their Twitter API v2 replacements in this release.
The following Labs v1 endpoints will be retired 60 days from today's release:
- Tweet metrics v1
- Filtered stream v1
- Sampled stream v1
The following Labs v2 endpoint will be retired 90 days from today’s release:
- Recent search v2
July 13th, 2020
Improvements to Hide replies
Twitter Developer Labs
We added the ability to unhide a reply. Additionally, previously unhidden replies can now be hidden again via this endpoint.
Get more details in the Hide replies documentation.
July 8th, 2020
Retiring certain Labs v1 endpoints
Twitter Developer Labs
Today we are retiring the Labs v1 Tweets and users, hide replies, and recent search endpoints.
You can read more about our Labs v1 plan in our forum announcement.
July 7th, 2020
Quote Tweets available for the /totals endpoint
Twitter API: Enterprise v1.1
Today, the quote_tweets
metric is now available for 'unowned' Tweets via the /totals endpoint. This means that you can access the Quote Tweet count for all Tweets by using app-only authentication.
You can read more about this change in our forum post.
July 1st, 2020
Adding two new Tweets metrics
Twitter Developer Labs
Today we are adding two new non-public metrics subfields, user_profile_clicks
and url_link_clicks
, to the Tweet object in the Twitter Developer Labs Tweet lookup endpoints. They will be returned when using the tweet.fields
parameter with any of the following values: non_public_metrics
, organic_metrics
, or promoted_metrics
.
To learn more, please visit the Tweet lookup API reference
June 15th, 2020
Changes to Twitter web, iOS and Android Retweet counts
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Starting today, Twitter web, iOS and Android will be showing the total 'Retweets and comments' count per Tweet. Using the Twitter API, the total 'Retweets and comments' number matching the Twitter interface can be calculated by adding the retweet_count
and quote_count
when available. Additionally quote_count
will be the total unique accounts that have quoted the Tweet, rather than the total Tweets quoting the Tweet. For more details, please see our forum post.
May 28th, 2020
Defining organic and promoted metrics groupings for Tweet and media objects
Twitter Developer Labs
We are adding organic_metrics
and promoted_metrics
to the Tweet and media objects in the Tweet lookup endpoints.
May 6th, 2020
Metrics in Tweets and recent search endpoints
Twitter Developer Labs
We are adding metrics to the Tweet and media objects in the Tweet lookup and recent search endpoints.
You can read more about these changes in our forum announcement
April 29th, 2020
COVID-19 Stream and Compliance endpoints
Twitter Developer Labs
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 31st, 2020
PowerTrack's Replay API now delivers current user profile data
Twitter API: Enterprise v1.1
Starting today, the Replay API will deliver user profile objects that reflect the referenced user at the time the Replay API is running. This change to deliver current user profile objects is similar to the recent Historical PowerTrack update below from Nov. 25, 2019.
March 23rd, 2020
Tweet annotations in Tweets and recent search endpoints
Twitter Developer Labs
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.
March 10th, 2020
Major updates to the Twitter Developer Policy
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today, we announced a significant update to the Developer Policy. We encourage you to read more about this via our forum and blog posts, and to review the revised policy. The Developer Policy is one of the foundations for your use of the Twitter API and it is important to understand your commitments.
February 26th, 2020
Introducting the hide replies endpoint
Twitter Developer Labs
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 25th, 2020
v2 of Labs endpoints: Tweets and Users, Recent Search, Hide Replies
Twitter Developer Labs
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
topublic_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.
February 7th, 2020
Twitter API: Enterprise v1.1
Today we added new drop/undrop event types to the Compliance Firehose API. You can read more about them in our documentation.
January 21st, 2020
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
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 15th, 2020
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Starting January 15, 2020, all connections to the Twitter API (and all other Twitter domains) will no longer support SPDY connections.
You can read more about this change in our forum announcement.
January 6th, 2020
New Recent search endpoint available in Labs
Twitter Developer 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 29th, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
A new updated major release of our Twitter API CLI, twurl
, is now available. This release includes a number of bug fixes and enhancements and introduces Bearer Token support which helps to add functionality around the Premium and Twitter Developer Labs endpoints. Read more in our forum post.
December 10th, 2019
Tweet annotations added to the Tweet Object for sampled stream and filtered stream endpoints in Labs
Twitter Developer 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.
November 25th, 2019
Twitter API: Enterprise v1.1
Today, we’re updating our "batch historical Tweets" endpoint (Historical PowerTrack) to provide user profile location, bio description, and display name information that reflects values in place at the of the job processing. When the updated user objects are delivered, there will be a new "updated" string array in the User/Actor object.
There are up to three possible values: name, description, location:
"updated": ["name", "description", "location"]
See the documentation on Historical PowerTrack's data format for more details.
October 29th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we’re releasing a new feature to the Account Activity API that will provide developers with the ability to view whether an account that mentions your subscribed user is blocked.
You can read more about the user_has_blocked data object structure and check out our forum announcement for more details.
October 22nd, 2019
New sampled stream endpoint available in Labs
Twitter Developer 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
Twitter Developer 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
Twitter Developer 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 15th, 2019
Twitter API: Standard v1.1
Starting today, applications that need to create Direct Messages will be required to have "Read, Write, and Direct Messages" app permissions (RW+DM). Applications attempting to create Direct Messages with only the RW app permission will receive the following error:
{"code": 93,"message": "This application is not allowed to access or delete your direct messages."}
You can learn more about this change via our forum announcement.
August 12th, 2019
New expansion for GET /users: pinned Tweet in Twitter Developer Labs
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:
Twitter Developer Labs
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.
July 25th, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Ads API Twitter Developer Labs
Today, all connections to the Twitter API (and all other Twitter domains) will require TLS 1.2.
You can read more about this change in our forum announcement.
July 15th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Starting today, we are introducing the new Account Activity API endpoint to deactivate user subscriptions using application-only OAuth.
This new endpoint offers developers the convenience of only having to provide a bearer token to deactivate a subscription, without requiring the subscribed user’s access token.
We are immediately marking the existing enterprise Account Activity API endpoint used to deactivate user subscriptions with 3-Legged OAuth as deprecated. The endpoint will be retired and no longer be available starting from January 15, 2020.
Developers can learn more about this API in our documentation.
June 20th, 2019
New expansions for GET /tweets: referenced author and mentioned user
Twitter Developer Labs
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.
June 11th, 2019
GET /tweets and GET /users are now supported in Labs
Twitter Developer 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.
June 10th, 2019
Twitter API: Standard v1.1
We have fully retired the Terms of Service and Privacy Endpoints. The current status of our Privacy Policy and Terms of Service is best served by our up-to-date web pages.
You can learn more about this change via our forum announcement.
May 21st, 2019
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today some user object fields, including user.lang, will start returning 'null' for updated metadata fields previously announced in our forum post.
Developers can learn about this change through our documentation.
May 20th, 2019
Twitter API: Enterprise v1.1
Starting today, we are introducing the Account Activity Replay API, a data recovery tool available with the enterprise tier of the Account Activity API
The Account Activity Replay API allows you to retrieve events from as far back as five days. It should be utilized to recover data in scenarios where your webhook server misses events
Developers can learn more about this API in our documentation.
May 6th, 2019
Twitter API: Enterprise v1.1
Starting today, native media (photos, videos, and GIFs) can be added to Quote Tweets on Twitter, which will be shown as additional media metadata in the entities sections of Quote Tweet payloads.
Developers can learn more about this in our documentation.
February 13th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, the operator is:reply becomes available to use with the enterprise search APIs and the paid version of the premium search endpoints.
The is:reply Boolean operator can be used to filter all replies to Tweets, or to filter out explicit replies that match a rule. This operator functions in the same way as the is:quote operator.
Remember that, with the Search API, all ‘is:’ and ‘has:’ operators must be used in conjunction with a standalone operator like a keyword or hashtag.
You can learn more about this operator in the documentation.
February 6th, 2019
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Starting today, the expanded URL enrichment will no longer contain the unwound URL object and metadata (including the title and description fields) for URLs linking to Tweets, Moments, or profiles. Please note that other URLs (to websites, etc.) will continue to be enriched with this metadata, and the url, expanded_url, and display_url
will still be available. This change applies to Decahose, PowerTrack, Historical PowerTrack, and the Search APIs.
November 29th, 2018
Twitter API: Enterprise v1.1
Today, we are introducing a new operator, is:reply, to help you narrow conversations to those you care about most. You can now filter out replies from your results (in addition to the pre-existing ability to filter out Retweets, is:retweet, and Quoted Tweets, is:quote). This new operator is available today within PowerTrack, Historical PowerTrack, and Replay.
The is:reply Boolean operator can be used to filter all replies to Tweets, or to filter out explicit replies that match a rule. This operator functions in the same way as the is:quote operator.
You can learn more about this operator in the documentation.
November 19th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Ads API Twitter Developer Labs
Today, we've added the ability for developers to view and edit their existing Twitter apps via the Twitter app dashboard on developer.twitter.com as long as they're logged into their Twitter account. Previously, you could only view and edit your existing Twitter apps on developer.twitter.com if you had applied or been approved for a developer account.
You still must have an approved developer account to be able to create new Twitter apps.
November 7th, 2018
Twitter API: Standard v1.1 Twitter Ads API
Today, we are announcing that advertisers and publishers are now able to add subtitle files (SRT) to their videos via ads.twitter.com, Media Studio and our publisher upload API. Subtitles will be viewable on auto-playing video (when no sound is available) on Android and Web. We will release the functionality for iOS in the coming weeks.
To read more about the new subtitles endpoints, please review their respective API reference pages:
November 5th, 2018
Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today we are announcing an update to the Account Activity API endpoint, GET subscriptions/count. To enable greater visibility into your billing details and use of the API, beginning today, you can programmatically pull the number of provisioned subscriptions associated with your Account Activity API instance within the JSON. This means you can now see both what your provisioned number of subscriptions are, and how close you are to hitting that limit via the GET subscriptions/count API endpoint.
This update has been documented with the Account Activity API documentation.
October 22nd, 2018
Twitter API: Standard v1.1
Today we are implementing new app-level rate limits on several of our standard POST endpoints:
- POST statuses/update
- POST statuses/retweet/:id
- POST favorites/create
- POST direct_messages/events/new
- POST friendships/create
You can read more about this change in our forum announcement.
October 10th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Today we are announcing an update to the twitter-text library to account for the recent changes to the way that Twitter counts emojis. If an emoji previously counted as more than two characters, its count will now be reduced to just two characters to allow for users to make the most out of their 280 characters.
You can read more about this change in our forum announcement.
September 17th, 2018
Twitter API: Standard v1.1
We have fully retired the legacy Direct Message endpoints. You can find a list of the retired DM endpoints, as well as their replacements on this page.
You can learn more about this update via our forum announcement.
September 11th, 2018
Twitter API: Standard v1.1
Today we are implementing some changes to the process where you retreive attached media from Direct Messages. We will no longer support accessing media_url
or media_url_https
via an authenticated www.twitter.com session. The request to fetch media_url_https
MUST always be signed with the user’s access token using OAuth 1.0A.
You can learn more about this update via our forum announcement.
August 23rd, 2018
Twitter API: Enterprise v1.1
We have fully retired User Streams and Site Streams.
You can learn more about this update via our forum announcement.
August 20th, 2018
Twitter API: Enterprise v1.1
Today we are launching a new version of the Usage API. With this update, we’re making the API more stable by moving to a new system.
With the system update, users will experience a data "hole" as developers will only be able to pull data back to May 1, 2018. Therefore for the upcoming year, they will be missing out on a few months of historical data (until June 2019).
A product name is changing within the Usage API from Historical PowerTrack Subscription to Historical PowerTrack 2.0 which will make the product naming consistent with the rest of our user-facing wording. Customers will receive the exact same data in the same format with the update. You will see this change within the products.type JSON object.
If you have any questions, please reach out to your account manager.
August 16th, 2018
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1
The Account Activity API DM Beta product was fully retired today.
The following services and endpoints will experience degraded service starting today:
- User Streams
- Site Streams
- GET direct_messages
- GET direct_messages/sent
- GET direct_messages/show
- POST direct_messages/new
- POST direct_messages/destroy
User Streams and Site Streams will be fully retired on August 23rd.
The legacy Direct Messages endpoints will be fully retired on September 17th.
You can learn more about this update via our forum announcement.
July 24th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
As of today, you will no longer be able to create new Twitter apps via apps.twitter.com. You will now be redirected to either your developer portal account or, if you don't have a developer portal account yet, to the page where you can apply.
We also announced that we will be implementing new app-level rate limits to the following POST endpoints on September 10th, 2018.
- POST statuses/update
- POST statuses/retweet:id
- POST friendships/create
- POST favorites/create
- POST direct_messages/events/new
Finally, we are introducing a new option for people to report suspected violations of our platform policies to you for review.
You can learn more about all of these updates via our blog post.
June 21st, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
If you have a developer portal account, you can now create and manage your Twitter apps. Please read our forum post for more details.
June 12th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Today, we started requiring that you register the callback URLs that you use with the Sign in with Twitter process. You can read more about this update here.
We also announced the addition of the tweet_delete_events activity to the Account Activity API. This new activity will be sent for those corresponding deleted events to enable developers to more easily provide a compliant experience for their customers and application users. You can read more about this new activity in our forum post or on our documentation.
May 25th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today, we made some changes to our Terms of Service, Privacy Policy, and Twitter Developer Agreement that include privacy, security, and data protection updates. Please read our forum post for more details.
May 23rd, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
Today, the timezone values in Twitter user objects became private fields. From here on out, all* time_zone and utc_offset data objects will return as null. Please read our forum post for more details.
* They will continue to be available on the account/settings endpoint, for authenticated users only.
May 21st, 2018
Twitter API: Enterprise v1.1
Today, we removed all Klout data from Tweet payloads as part of our GDPR updates.
May 14th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we are changing all instances of profile_background_image_url and profile_background_image_url_https to their default values. Please read our forum post for more details.
In addition to the above change, we are adding a new field to the Account Activity API payloads to reference which subscription the activity was delivered for. This JSON object is called for_user_id and will include the subscribed user's ID who produced that activity as its value. You can see some examples of this new JSON object in our account activity objects page.
May 10th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Today, we are announcing a change to the way that URLs will be rendered in the Quote Tweet payload.
We’re adding a new entity called the "quoted_status_permalink" entity to ensure the quoted Tweet can be referenced and we will be removing the t.co link from the quoted Tweet "text" field.
With the new format, the t.co link is no longer appended to the "text" field of the quoted Tweet in the "quoted_status" object.
Further, we will no longer put the quoted Tweet t.co url, expanded_url, and display_url in the ‘urls’ entity. Instead, these will be added to a new "quoted_status_permalink" object with "url", "expanded", and "display" URL attributes. This means that the "quoted_status_permalink" object will be reserved for the t.co link back to the quoted Tweet, whereas the "entities.urls" array can be used to identify any links shared within the original Tweet or Quote Tweet.
Please read our forum post and updated documentation for more details.
April 30th, 2018
Twitter for Websites
The announcement of Twitter Kit deprecation, after October 31, 2018 Twitter Kit will no longer be actively maintained. Please read our blog post for more details.
April 24th, 2018
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Today we announced several updates to the platform related to GDPR. Please read our forum post for more details.
March 1, 2018
Twitter API: Enterprise v1.1
The addition of a new object to the Tweet payload – additional_media_info object – and also restricting some video details (video_info) for promoted Tweets where advertisers have requested we limit video playback to Twitter owned clients. You can find additional information about this change at the following link: Extended Entities Objects > Tweet with native video.
February 1st, 2018
Twitter API: Premium v1.1
Launch of the premium full-archive search endpoint.
December 19th, 2017
Twitter API: Premium v1.1
Launched both (All Activities) and (Direct Messages) Standard beta Account Activity APIs, read more about this launch on our blog. Announced User streams & Site streams deprecation and sunset date of Tuesday June 19, 2018.
December 15th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
Version 2.0 of twitter-text is now available on GitHub. This update addresses the change in our character limit that was rolled out on November 7th, 2017. To learn more about this update, please visit our forum.
November 14th, 2017
Twitter API: Premium v1.1
Launched the Premium APIs.
These new APIs build on the quality and stability of our enterprise data platform, and make it available more widely via a tiered pricing model. For the first time, you can start to search across 30 days of Tweets (instead of the limited 7 days of data on the standard endpoint), and optionally, you can also access our premium enrichments for profile geo, URL expansion, and poll data. Here’s a taste of some of the new features:
- More Tweets per request (Sandbox + Premium)
- A far more rich query language enabling more complex queries (Sandbox + Premium)
- A counts endpoint that returns time-series counts of Tweets (Premium)
- Metadata enrichments, such as expanded URLs and Profile Geo (Premium)
Read more about this launch on our blog.
November 7th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter for Websites Twitter Developer Labs
Official launch of 280 character Tweets in languages where cramming was an issue. Please see our forum announcement or official blog post for further reference.
November 1st, 2017
Twitter API: Standard v1.1
The ability to send Direct Messages via the statuses/update API endpoint has been completely removed, and the enable_dm_commands
and fail_dm_commands
parameters will no longer have any effect. Read more about this update on our forum.
October 11th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
A change was made to Twitter’s backend OAuth API endpoints which altered the behaviour of the /oauth/authenticate endpoint to match that of the /oauth/authorize endpoint. Read more about this update on our forum.
October 10th, 2017
Twitter API: Enterprise v1.1
The Engagement API was updated to use the same metrics aggregation methodology in use by the Twitter analytics dashboard. Read more about this update on our forum.
October 1st, 2017
Twitter API: Standard v1.1
The default value of the fail_dm_commands
parameter within the DM statuses/update endpoint has been switched to true. All status updates intended as Direct Messages will start to return errors (unless enable_dm_commands
is false, in which case the Tweet will be posted). Read more about this update on our forum.
September 26th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Twitter Ads API Twitter Developer Labs
The response payload for 280 character tweets will be treated the same way as long tweets. Read more about this update on our forum.
September 11th, 2017
Twitter API: Standard v1.1 Twitter API: Premium v1.1 Twitter API: Enterprise v1.1
Adding new data to the Tweet payload (additional_media_info object
) and also restricting some video details (video_info
) for promoted Tweets where advertisers have requested we limit video playback to Twitter owned clients. You can find additional information about this change at the following link: Extended Entities Objects > Tweet with native video
August 7, 2017
Twitter API: Enterprise v1.1
30-Day and Full-Archive Search ended support for url_contains: operator. Deprecation of this operator was announced as part of the Gnip 2.0 migration in August 2016. Any Search query using the url_contains: Operator will be rejected as invalid.
July 6, 2017
Twitter API: Enterprise v1.1
The enterprise Search API (both 30-Day and Full-Archive) will no longer support the url_contains: operator beginning 30 days from today, or after August 4, 2017 (Support of url_contains: will actually end with the first deploy after that date). Deprecation of this operator was announced as part of the Gnip 2.0 migration in August 2016. When Operator support is ended, any query using the url_contains: will be rejected as invalid.
June 2nd, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
The xAuth authentication mechanism has been removed from all Twitter APIs Read more about this update on our forum.
May 8th, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
All HTTP headers have been forced into lowercase (content-type
, x-rate-limit-remaining
, x-access-level
etc). Read more about this update on our forum.
May 5th, 2017
Twitter API: Standard v1.1
The optional enable_dm_commands
parameter to statuses/update will enable applications to remove DM command support early, before the transition period ends. The default value is true (i.e. current legacy behavior), but this may be set to false to get the new, post-November 1 behavior. The optional fail_dm_commands parameter to statuses/update will make DM commands return HTTP 403 (error code 151) from the API when set to true. The default value is false. Read more about this update on our forum.
April 25th, 2017
Twitter API: Enterprise v1.1
Rules with emojis are now available in the enterprise Search APIs
April 6th, 2017
Twitter API: Standard v1.1
Access to several new Direct Message APIs are now more widely available. Read more about this update on our blog.
March 9th, 2017
Twitter API: Standard v1.1 Twitter API: Enterprise v1.1 Twitter Ads API
MPEG-DASH URLs (.mpd) has been removed from the payload of a Tweet that contains video. Read more about this update on our forum.
February 22nd, 2017
Twitter API: Enterprise v1.1
New Enrichment! Poll Metadata is now available through our enterprise APIs. See the documentation for more details.
New payload field: Image Alt-Text (decription) field may be present in the entities.media[] and extended_entities.media[] section of the payload if a user chooses chooses the "Add description" option when adding a photo to a Tweet. This is available in enriched native format only.
Default payload format: Newly created streams on Gnip products will now default to orriginal format JSON.
January 23rd, 2017
Twitter API: Enterprise v1.1
Historical PowerTrack API & Replay API
- Quote Tweet filtering is now supported
- Quoted Tweets are now fully rehydrated within HPT and Replay Tweet payloads
January 17th, 2017
Twitter API: Enterprise v1.1
New payload fields: quote_count and reply_count are now available in native enriched format payloads across Realtime and Historical APIs
December 20th, 2016
Twitter API: Enterprise v1.1
Full-Archive Search API (FAS):
- Added support for additional geo operators:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality:
December 5th, 2016
Twitter API: Enterprise v1.1
Rule management (GET and DELETE) by Rule ID is now available for PowerTrack 2.0 and PowerTrack Replay 2.0
November 10th, 2016
Twitter API: Enterprise v1.1
30-Day Search API:
- Added support for additional geo operators:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality: