January 16, 2025
X API
Today, we launched new X API v2 Media Upload endpoints. Learn more here.
September 23, 2024
X API v2
Today, we added the DM blocking and DM unblocking endpoints to the X API v2.
August 20, 2024
X API v2
Today, we added the ability to create longform Posts with a length of 25k instead of 4k.
August 9, 2024
X API v2
Today, we added the ability to create long form Posts using the X API v2
August 2, 2024
X API v2
Today, we added the ability to retrieve a User’s affiliation programmatically using the X API v2
July 26, 2024
X API v2
Today, we added the ability to get Article metadata using the X API v2
June 17, 2024
X API v2
Today, we added the ability to get profile Image and cover picture URL via the X V2 API
January 16, 2024
X API v2
Today, we added the connection_status field in the X API v2. Learn more about it here.
November 20, 2023
X API v2
Today, we launched a subscription_type field on the User object in the X API v2. Learn more about it quotes lookup endpoint that lets you get the quotes for a post ID.
To learn more about this launch, please visit our Likes lookup endpoints, allowing you to get back the complete list of accounts who have Liked or reposted a post, not just the last 100 accounts to do so.
To learn more about this launch, please visit our forum announcement to learn more about this launch.
December 14th, 2021
X API v2: Authentication
Today, all developers can now authenticate using OAuth 2.0 by selecting OAuth 2.0 as an authentication method in the developer portal. We’ve added support for confidential and public clients and all relevant v2 endpoints to use this authentication method as part of this release.
OAuth 2.0 is an industry-standard authorization protocol that provides developers more control over an application’s scopes and improves authorization flows across multiple devices. In other words, developers building applications for people on X will have more control over the information their App requests from its users, so that you only have to ask your end-users for the data and information you need.
This modern authorization protocol will allow you to present your end-users with a more streamlined consent flow for authorizing your app, which only displays the specific scopes you have requested from them.
To learn more about this launch, please visit our forum announcement.
November 15th, 2021
X API v2: Early Access
Major platform updates: X API v2 is now the primary version, new Essential and Elevated access, and Policy changes
Today, we are announcing that X API v2 is now the primary version of the X API. We have launched enough endpoints and functionality into X API v2 to satisfy the needs of 90% of all existing Apps built on the X API.
We are launching the following changes today to further improve upon the X API v2 developer experience:
-
Fast and free Essential access to the API, and free Elevated access to developers who have had their use cases approved. We have a lot more details on these access levels available on our About the X API page.
-
We are removing language in our Developer Policy that restricted how you build with X’s core features, and limited the number of users you can support through your app.
-
We are opening up our platform to encourage you to build tools and products that make X better, healthier, and extend the public conversation. See a list of solutions we’d love to see you build.
-
Specifically, we’ve removed terms that restricted replication of the X experience, including X’s core features as well as terms that required permission to have high numbers of user tokens.
-
We know that building solutions that help people on X often means a developer has to build (or replicate) some of the things that are available on X. These changes to our Developer Policy are intended to drive clarity for the developer ecosystem and provide an open API platform that makes it easier for developers to build, innovate, and make an impact on the public conversation.
We go into a lot more detail on this launch and the X API launches that led to this moment in our forum post.
In addition to exploring earlier changelog entries, we’ve put together some key resources that you can review to understand what all has released to X API v2 to-date:
November 15th, 2021
X API v2: Early Access
Today, we’re launching the new List lookup endpoints to X API v2. These endpoints will allow users to retrieve details on specified Lists such as followers, members, posts and more. The data retrieved can be used to build solutions that solve for curation, analysis and discoverability use cases and needs. In addition to new List endpoints, a new list: operator has been made available at the Academic Research access level. This will be available to use on search posts and post counts.
To learn more about this launch, please visit our forum announcement.
September 29th, 2021
X API v2: Early Access
Today, we’re launching the new Lists endpoint group to X API v2. These endpoints will allow you to build solutions that curate and organize posts based on preferences, interests, groups, or topics.
To learn more about this launch, please visit our forum announcement.
August 18th, 2021
Spaces endpoints now available in X API v2
X API v2: Early Access
Today, we’re launching the new manage mutes endpoints to the X API v2. These endpoints will allow authenticated users to mute or unmute accounts.
To learn more about this launch, please visit our forum announcement.
New limits for max_results when requesting context_annotations field
X API v2: Early Access
We have now reduced the max_results that can deliver with 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 X API v2 Academic Research product track
X API v2: Early Access
Today, we are introducing the new Academic Research product track to X 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 X API v2 full-archive search endpoint, which is only available to the Academic Research product track at this time.
-
An increased access level.
-
New filter operators available to 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 and has: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 post field for v2 X API
X API v2: Early Access
Today we are launching a new field in the post object called reply_settings. This field is available on all X API v2 endpoints that return posts including post lookup, hide replies, recent search, sampled stream, filtered stream, follows lookup, user post timeline, and user mention timeline endpoints or by follows lookup endpoints to the X 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
X 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 X API v2 versions:
We also have additional details about migration to the new X 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
X Developer Labs
On August 12th, 2020, we launched the new X API v2: Early access. With this release, we graduated several endpoints to X 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 X API v2 versions:
We also have additional details about migration to the new X API v2 via our post cap of 500,000 posts 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 Early Access to the first endpoints of the new X API!
The new X 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 post, user, and media fields; and a set of updated endpoints that enable you to listen to and analyze posts, including the following:
You can find a full list of the new functionality available, and find migration resources on our [X API v2: Early Access docs page]forum announcement.
February 25th, 2020
v2 of Labs endpoints: posts and Users, Recent Search, Hide Replies
X Developer Labs
Today, we are bringing our posts 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 posts and Users:
-
Introduce fields as a query parameter
-
Remove formats as a query parameter
-
Add path variable for single ID lookup in posts 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:
The core search, pagination and other functionality of Recent Search will stay the same.
We have put together some new streaming endpoint to retrieve posts, and an endpoint to manage your filters in X Developer Labs. With these endpoints, you will be able to retrieve up to 500,000 posts per month (maximum 50 posts 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 GET /tweets/metrics/private supports the following metrics:
Learn more about this launch via our forum announcement.
July 15th, 2019
X API: Premium v1.1 X API: Enterprise v1.1
Starting today, we are introducing the new documentation.
June 20th, 2019
New expansions for GET /tweets: referenced author and mentioned user
X Developer Labs
We added two new expansions to the [GET /tweets]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 posts, 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.
May 21st, 2019
X API: Standard v1.1 X API: Premium v1.1 X API: Enterprise v1.1
Today some user object fields, including user.lang, will start returning ‘null’ for updated metadata fields previously announced in our X app dashboard on developer.x.com as long as they’re logged into their X account. Previously, you could only view and edit your existing X apps on developer.x.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 X apps.
November 7th, 2018
X API: Standard v1.1 X Ads API
Today, we are announcing that advertisers and publishers are now able to add subtitle files (SRT) to their videos via ads.x.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
X API: Premium v1.1 X API: Enterprise v1.1
Today we are announcing an update to the Account Activity API documentation.
October 22nd, 2018
X API: Standard v1.1
Today we are implementing new app-level rate limits on several of our standard POST endpoints:
You can read more about this change in our retreive attached media from Direct Messages. We will no longer support accessing media_url or media_url_https via an authenticated forum announcement.
August 20th, 2018
X 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
X API: Standard v1.1 X 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 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 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.
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 forum post or on our documentation.
May 25th, 2018
X API: Standard v1.1 X API: Premium v1.1 X API: Enterprise v1.1
X Ads API X for Websites X Developer Labs
Today, we made some changes to our forum post for more details.
May 23rd, 2018
X API: Standard v1.1 X API: Premium v1.1 X API: Enterprise v1.1 X Ads API
Today, the timezone values in X 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
X API: Enterprise v1.1
Today, we removed all Klout data from post payloads as part of our GDPR updates.
May 14th, 2018
X API: Standard v1.1 X API: Premium v1.1 X 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 X Kit deprecation, after October 31, 2018 X Kit will no longer be actively maintained. Please read our premium full-archive search endpoint.
December 19th, 2017
X API: Premium v1.1
Launched both (Direct Messages) Standard beta Account Activity APIs, read more about this launch visit our forum.
November 14th, 2017
X 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 posts (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 posts 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 posts (Premium)
-
Metadata enrichments, such as expanded URLs and Profile Geo (Premium)
Read more about this launch on our forum.
October 11th, 2017
X API: Standard v1.1 X API: Premium v1.1 X API: Enterprise v1.1
X Ads API X Developer Labs
A change was made to X’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.
September 11th, 2017
X API: Standard v1.1 X API: Premium v1.1 X API: Enterprise v1.1
Adding new data to the post payload (additional_media_info object) and also restricting some video details (video_info) for promoted posts where advertisers have requested we limit video playback to X owned clients. You can find additional information about this change at the following link: on our forum.
April 25th, 2017
X API: Enterprise v1.1
Rules with emojis are now available in the enterprise Search APIs
April 6th, 2017
X API: Standard v1.1
Access to several new Direct Message APIs are now more widely available. Read more about this update on our forum.
February 22nd, 2017
X 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 post. 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
X API: Enterprise v1.1
Historical PowerTrack API & Replay API
January 17th, 2017
X 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
X API: Enterprise v1.1
Full-Archive Search API (FAS):
December 5th, 2016
X 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
X API: Enterprise v1.1
30-Day Search API: