Documentation Index Fetch the complete documentation index at: /llms.txt Use this file to discover all available pages before exploring further. ​ Free credit incentives for pay-per-use accounts ​ Real-time reply moderation guide now uses Grok ​ Broadcast chat removal events for X Activity API ​ Migrate OAuth 1.0a user tokens to OAuth 2.0 with token exchange ​ Conversion API Google Tag Manager server-side template ​ REGIONS segmentation for Analytics ​ Lead Generation API POST /12/accounts/:account_id/lead_forms creates a form (introduction, fields, privacy policy, and optional thank-you page) POST /12/accounts/:account_id/cards accepts destination type LEAD_FORM POST /12/accounts/:account_id/ad-export/api/v1/exports with entity_type=leads exports submissions for a form and time window ​ Media upload and Post-create size and duration limits Default accounts: Post video up to 20 minutes and 8 GB ( tweet_video / amplify_video ) X Premium / verified: Post video up to 125 minutes and 16 GB Direct Message video is unchanged: 140 seconds / 512 MB default, 10 minutes / 1 GB Premium Exceeding the posting user’s duration cap returns 403 This user is not allowed to post a video longer than N minutes. ​ Updated video_total_views definition ​ Mute and block events for X Activity API ​ Articles draft and publish endpoints ​ Post create and delete events for X Activity API ​ paid_partnership Post field When creating a Post via POST /2/tweets , set "paid_partnership": true to indicate the Post is a paid partnership (i.e., the author is disclosing that it contains paid promotion). The Post will be labeled as a paid promotion. When reading Posts, request tweet.fields=paid_partnership to retrieve the value ( true if the author has disclosed the Post as containing paid promotion). ​ Search endpoints migrating to new search index ​ X API pricing update: Owned Reads now $0.001 ​ Deprecation of Account Activity replay endpoint ​ Direction filter for X Activity API subscriptions ​ Updates to event types format in the X Activity API ​ Legacy Direct Message events in the X Activity API ​ Addressing LLM-generated spam ​ Launch of X API Pay-Per-Use pricing A new Developer Console at console.x.com The XDK (X Developer Kit) with first-party Python and TypeScript SDKs An interactive Playground for testing An MCP server for AI models Earn up to 20% back in xAI/Grok API credits on every dollar spent on the X API ​ Spaces events in the X Activity API ​ Deprecating count-based operators ​ OAuth 2.0 support added to Account Activity API v2 ​ Introducing X API Playground ​ Launch of news endpoints GET /2/news/search — returns trending news stories matching a search query GET /2/news/{id} — looks up a specific news story by ID ​ Launch of the Python and TypeScript XDKs ​ Keyword filtering for X Activity API subscriptions ​ Verified badge, affiliate badge, and handle update events in the X Activity API profile.update.verified — when a user’s verification status changes profile.update.affiliate — when a user’s affiliate badge changes profile.update.screenname — when a user changes their @handle ​ X API Pay-Per-Use pricing pilot ​ Launch of the X Activity API open beta ​ Post editing via the X API ​ Connections API for managing active streaming connections GET /2/connections — list active and historical streaming connections DELETE /2/connections/all — terminate all active streaming connections for the app DELETE /2/connections/{endpoint_id} — terminate connections for a specific streaming endpoint DELETE /2/connections — terminate specific connections by UUID ​ Community Notes: evaluate note endpoint ​ Launch of the Filtered Stream Webhooks API ​ Removal of like and follow endpoints from Free tier ​ PowerStream rules lookup endpoint ​ Broadcasting community posts via share_with_followers ​ Launch of the Community Notes API GET /2/notes/search/posts_eligible_for_notes — search Posts eligible to receive a Community Note GET /2/notes/search/notes_written — retrieve notes previously written by the authenticated AI Note Writer POST /2/notes — submit a Community Note ​ Change to DM events behavior ​ Launch of Account Activity API endpoints ​ Improvements to media upload endpoint ​ Support for email address retrieval with OAuth 2.0 ​ Changes to user affiliation data ​ Launch of media upload endpoints ​ Launch of new documentation site ​ Launch of xurl tool ​ Addition of community ID tweet field ​ Addition of DM blocking endpoints ​ Support for longform posts ​ Support for long form posts ​ Retrieve user affiliation ​ Get article metadata ​ Get profile image and cover picture ​ Addition of connection status field ​ Addition of trends lookup endpoint ​ Addition of users search endpoint ​ Get DM permissions ​ Launch of subscription type field ​ Get posts usage endpoint ​ Launch of reposts lookup endpoint ​ Deprecation of search endpoints ​ Deprecation of Replay API endpoint ​ Deprecation of historical Powertrack endpoints ​ Removal of follows endpoints from Basic and Pro Tiers ​ Removal of manage blocks endpoint ​ Support for Bookmarks count and long posts ​ Deprecation of Statuses/Filter endpoint ​ Support for view counts ​ Addition of verified type field ​ Removal of source field ​ Addition of Direct Messages endpoints ​ Support for edited post metadata ​ Addition of filtering operator aliases ​ Updates to reverse chronological home timeline ​ New filtering operators for Filtered Stream ​ Updates to streaming endpoints latency ​ Enabling v1.1 media endpoints in Essential Access ​ Launch of Reverse Chronological Home Timeline endpoint ​ Launch of Bookmarks endpoints ​ Launch of quotes lookup endpoint ​ Updates to documentation navigation ​ Improvements to reposts and likes lookup endpoints ​ Support for OAuth 2.0 authentication ​ Major platform updates to X API v2 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 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. X API endpoint map About the X API ​ Launch of list lookup endpoints ​ Additions to Spaces endpoints ​ Launch of manage posts endpoints ​ Changes to embedded buttons ​ Launch of lists endpoint group ​ Launch of mutes lookup endpoint ​ Launch of OAuth 2.0 beta ​ Launch of Batch Compliance endpoints ​ Launch of Spaces endpoints ​ New object for video views limitation ​ Addition of alt text field ​ Launch of reposts endpoints ​ Launch of manage mutes endpoints ​ Reliability features for streaming endpoints ​ Launch of post counts endpoints ​ Improvements to teams ​ Retirement of configuration endpoint ​ Consolidation of oembed endpoint ​ Launch of blocks and likes lookup endpoints ​ Launch of manage likes endpoints ​ Launch of manage blocks endpoints ​ Removal of support for embedded timelines ​ Launch of manage follows endpoints ​ Introduction of Academic Research product track The new X API v2 full-archive search endpoint , which is only available to the Academic Research product track at this time. An increased post 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 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 track at the Basic access level

​ Addition of reply settings field ​ Launch of user post and mention timeline endpoints ​ Launch of follows lookup endpoints ​ Retirement of Labs v2 endpoints Recent search v2 Hide replies v2 ​ Retirement of Labs v1 endpoints post metrics v1 Filtered stream v1 Sampled stream v1 ​ Addition of post consumption status bar ​ Launch of Hide Replies endpoint ​ Early access to X API v2 endpoints Filtered stream ​ Deprecation of Labs endpoints post metrics v1 Filtered stream v1 Sampled stream v1 Recent search v2 ​ Improvements to hide replies ​ Retirement of Labs v1 endpoints ​ Addition of quote tweets metric ​ Addition of new post metrics ​ Changes to repost counts ​ Organic and promoted metrics groupings ​ Addition of metrics to endpoints ​ Launch of COVID-19 endpoints ​ Updates to Replay API user profiles ​ Addition of post annotations ​ Updates to developer policy ​ Launch of Hide Replies endpoint ​ Release of v2 Labs endpoints 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 Remove the most_recent_tweet_id expansion in Users Remove HTML tags from the source field in posts to make that field easier to parse ​ Addition of drop/undrop events to Compliance Firehose ​ Changes to access token management ​ Removal of SPDY support ​ Launch of recent search endpoint in Labs ​ Update to Twurl CLI ​ Addition of post annotations in streams ​ Updates to Historical PowerTrack user profiles ​ Addition to Account Activity API ​ Launch of sampled stream endpoint in Labs ​ Launch of Filtered Stream endpoint in Labs ​ Launch of post metrics in Labs video view quartiles (where the requester is also the author of the media) ​ Changes to DM permissions ​ Addition of pinned post expansion ​ Addition of quote counts metadata ​ Addition of most recent post expansion ​ Requirement for TLS 1.2 ​ New Account Activity API endpoint ​ New expansions for tweets endpoint ​ Support for tweets and users endpoints in Labs 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, e.g.) 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) ​ Retirement of terms and privacy endpoints ​ Changes to user object fields ​ Launch of Account Activity Replay API ​ Support for native media in quotes ​ Addition of is:reply operator ​ Changes to expanded URL enrichment ​ Addition of is:reply operator in PowerTrack ​ Access to apps in Developer Console ​ Support for video subtitles POST media/subtitles-create POST media/subtitles-delete ​ Update to Account Activity API endpoint ​ New rate limits on POST endpoints POST statuses/update POST statuses/retweet/:id POST favorites/create POST direct_messages/events/new POST friendships/create ​ Update to twitter-text library ​ Retirement of legacy DM endpoints ​ Changes to DM media access ​ Retirement of user and site streams ​ New version of Usage API ​ API deprecations GET direct_messages GET direct_messages/sent GET direct_messages/show POST direct_messages/new POST direct_messages/destroy ​ Changes to app creation and rate limits POST statuses/update POST statuses/retweet:id POST friendships/create POST favorites/create POST direct_messages/events/new ​ App management in Developer Console ​ Changes to Sign in with X and Account Activity ​ Updates to terms and policies ​ Timezone fields made private ​ Removal of Klout data ​ Changes to profile background and Account Activity ​ Changes to quote payload rendering ​ Deprecation of X Kit ​ Platform updates for GDPR ​ Addition of additional media info object ​ Launch of premium full-archive search ​ Launch of Account Activity APIs ​ Update to twitter-text library ​ Launch of premium APIs 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) ​ Launch of 280 character posts ​ Removal of DM commands in Statuses/Update ​ Changes to OAuth login flow ​ Updates to Engagement API metrics ​ Changes to DM commands failure ​ Treatment of 280 character tweets ​ Addition of additional media info ​ End of support for url_contains operator in 30-Day Search ​ Upcoming removal of url_contains operator in search APIs ​ Retirement of xAuth ​ HTTP headers forced to lowercase ​ Optional parameters for DM commands ​ Support for emojis in rules ​ Wider availability of Direct Message APIs ​ Retirement of MPEG-DASH video support ​ New enrichments and payload changes ​ Updates to Historical PowerTrack and Replay API quote filtering is now supported Quoted posts are now fully rehydrated within HPT and Replay post payloads ​ New payload fields for counts ​ Support for geo operators in Full-Archive Search Added support for additional geo operators: has:profile_geo: profile_country: profile_region: profile_locality: ​ Rule management by ID in PowerTrack ​ Support for geo operators in 30-Day Search Added support for additional geo operators: has:profile_geo: profile_country: profile_region: profile_locality: