About the X API

The X API can be used to programmatically retrieve and analyze X data, as well as build for the conversation on X. Over the years, the X API has grown by adding additional levels of access for developers to be able to scale their access to enhance and research the public conversation. Recently, we released the X API v2. The X API v2 includes a modern foundation, new and advanced features, and quick onboarding to Basic access. The following three tabs explain the different versions and access levels of the X API, what’s new with v2, and which X resources you can retrieve, create, destroy, and adjust using the API.

Access levels and versions
What's new with v2
X API resources

X API access levels and versions

While the X API v2 is the primary X API, the platform currently supports previous versions (v1.1, Gnip 2.0) as well. We recommend that all users start with v2 as this is where all future innovation will happen.The X API v2 includes a few access levels:

	Free	Basic	Pro	Enterprise
Getting access	Get Started	Get Started	Get Started	Get Started
Price	Free	$200/month	$5000/month	-
Access to X API v2	✔️	✔️	✔️	✔️
Access to standard v1.1	✔️ (Limited)	✔️ (Limited)	✔️ (Limited)	✔️
Project limits	1 Project	1 Project	1 Project	-
App limits	1 App per Project	2 Apps per Project	3 Apps per Project	-
Post caps (per month)	100	15,000	1,000,000	-
Enterprise stream APIs	❌	❌	❌	✔️
Filtered stream API	❌	❌	✔️	✔️
Access to full-archive search	❌	❌	✔️	✔️

What’s new with v2

The X API v2 represents the largest upgrade of the X API since 2012. With it comes a host of new and advanced features, as well as fast and free access to the API.Some of the features that are available with v2 include the following:

New endpoints

We have released a set of net-new endpoints to X API v2. You can see a full list of v2 endpoints, including those that are new, on our X API endpoint map guide.Visit the X API endpoint map >

New and more detailed data objects

We’ve modernized our data objects with a variety off new improvements that will enable you to more easily navigate and parse data.Visit the data dictionary >

New parameters to help you retrieve just those objects and fields that you want

We’ve added fields and expansions parameters to our data endpoints that allow you to request related objects and fields beyond those fields that return by default.Learn how to use fields and expansions >

Advanced metrics

More easily understand the performance of Posts, users, media, and polls from directly within your payload by requesting both public and private metrics including impressions, video views, user profile, and URL clicks, some of which are separated into an organic and promoted context.Learn more about metrics >

Filter on and identify which Posts contain different topics

When using search Posts or filtered stream, you can now filter by topic using our entity and context operators. We’ve also provided these topics within the Post payload to help with analysis.Learn more about Post annotations >

Filter on and identify which Posts belong to a reply thread

Make it easier to identify a Post as part of a conversation thread when using search Posts, filtered stream, and Post lookup. We’ve also added the ability to determine whether conversation reply settings have been set for a Post with the Post field reply_settings.Learn more about conversation tracking >

And so much more…

High confidence spam filtering
Shortened URLs are fully unwound for easier URL analysis
Simplified JSON response objects by removing deprecated fields and modernizing labels
Recovery and redundancy functionality for our streaming endpoints
Return of 100% of matching public and available Posts in search queries
Streaming “rules” so you can make changes without dropping connections
More expressive query language for filtered stream and search
OpenAPI spec to build new libraries & more transparently track changes
API support for new features and endpoints more quickly as our platform evolves to meet the needs of developers, researchers, businesses, and people using X

X API platform resources

In the API design space, a resource is an entity with associated data, relationships to other resources, and a set of methods that operate on it. For example, a Post is a resource that you can create, delete, or retrieve using a variety of different tools, such as historically searching for them, or retrieving them in real-time.The X API provides access to create, delete, receive, or adjust a variety of different resources on the platform including the following:

Resource	Description
Posts	Tap into millions of Posts to understand the public conversation, or create your own to engage with the conversation. Current availability: - X API v2 - Enterprise - Standard v1.1
Users	Manage or look up X users to analyze networks, understand your audience, or foster positive online relationships. Current availability: - X API v2 - Enterprise - Standard v1.1
Spaces	Look up and search X Spaces and their attendees to help people find interesting and relevant audio conversations. Current availability: - X API v2
Direct Messages	Send and receive Direct Messages to triage customer issues, send welcome messages, or create positive human interaction. Current availability: - Standard v1.1
Lists	Curate and manage lists of accounts to keep a pulse on industry experts, powerful voices, or organize who you follow. Current availability: - X API v2 - Standard v1.1
Trends	Identify geographic trends first to pinpoint industry movement, discover hot topics, or stay ahead of the latest fad. Current availability: - Standard v1.1
Media	Upload media objects to share your creative energy, create interactive experiences, or build accessibility tools. Current availability: - Standard v1.1
Places	Search for places to understand what’s happening in your neighborhood and around the world. Current availability: - Standard v1.1

Other X API offerings

Enterprise APIs (Formerly Gnip 2.0)

Overview

Posts

Users

Direct Messages

Likes

Lists

Spaces

Communities

Community Notes

Trends

News

Media

X Activity

Usage

Stream Connections

Compliance

Enterprise v2

Likes Streams

GNIP 2.0

About the X API

X API access levels and versions

What’s new with v2

New endpoints

New and more detailed data objects

New parameters to help you retrieve just those objects and fields that you want

Advanced metrics

Filter on and identify which Posts contain different topics

Filter on and identify which Posts belong to a reply thread

And so much more…

X API platform resources

Other X API offerings

Overview

Posts

Users

Direct Messages

Likes

Lists

Spaces

Communities

Community Notes

Trends

News

Media

X Activity

Usage

Stream Connections

Compliance

Enterprise v2

Likes Streams

GNIP 2.0

​X API access levels and versions

​What’s new with v2

​New endpoints

​New and more detailed data objects

​New parameters to help you retrieve just those objects and fields that you want

​Advanced metrics

​Filter on and identify which Posts contain different topics

​Filter on and identify which Posts belong to a reply thread

​And so much more…

​X API platform resources

​Other X API offerings

X API access levels and versions

What’s new with v2

New endpoints

New and more detailed data objects

New parameters to help you retrieve just those objects and fields that you want

Advanced metrics

Filter on and identify which Posts contain different topics

Filter on and identify which Posts belong to a reply thread

And so much more…

X API platform resources

Other X API offerings