About the X API

Overview of X API capabilities, versions, and resources

The X API provides programmatic access to X’s public conversation. Retrieve posts, analyze trends, build integrations, and create new experiences on the platform.

---

What you can do

Capability	Description
Read posts	Search, look up, and stream posts in real-time
Publish content	Create posts, replies, and threads
Manage users	Look up users, manage follows, blocks, and mutes
Analyze data	Access metrics, trends, and engagement analytics
Build integrations	Send DMs, manage lists, and interact with Spaces

---

API versions

X API v2 (Recommended)

The current version of the X API with modern features and flexible pricing.

Why use v2:

• Pay-per-usage pricing—no monthly caps
• Modern JSON response format
• Flexible fields and expansions
• Advanced features: annotations, conversation tracking, edit history
• All new endpoints and features

Getting started:

1. Sign up at console.x.com
2. Create an app and get credentials
3. Make your first request

X API v1.1 (Legacy)

The previous version of the X API. Limited support; use v2 for new projects.

Still available:

• Some media upload endpoints
• Legacy streaming (deprecated)
• Some specialized endpoints

Migrating to v2: See the migration guide for endpoint mapping and data format changes.

Enterprise

High-volume access for businesses with advanced needs.

Features:

• Complete firehose access
• Historical data backfill
• Dedicated support
• Custom rate limits
• Compliance streams

Contact enterprise sales →

---

Available resources

The X API provides access to these resource types:

Posts

Search, retrieve, create, and delete posts. Access timelines, threads, and quote posts.

Users

Look up profiles, manage relationships, and access follower data.

Spaces

Discover live audio conversations and participants.

Direct Messages

Send and receive private messages between users.

Lists

Create and manage curated lists of accounts.

Trends

Access trending topics by location.

---

v2 highlights

Fields and expansions

Request only the data you need. Use fields parameters to select specific attributes and expansions to include related objects.

curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
  -H "Authorization: Bearer $TOKEN"

Learn more about fields →

Post annotations

Posts include semantic annotations identifying people, places, products, and topics. Filter streams and searches by topic.

Learn more about annotations →

Engagement metrics

Access public metrics (likes, reposts, replies) and private metrics (impressions, clicks) for your own posts.

Learn more about metrics →

Conversation tracking

Reconstruct entire conversation threads using conversation_id. Track replies across the full thread.

Learn more about conversation tracking →

Edit history

Access the edit history of posts, including all previous versions and edit metadata.

Learn more about edit posts →

---

Pricing

X API v2 uses pay-per-usage pricing:

Benefit	Description
No subscriptions	Pay only for what you use
No caps	Use as much as you need
Credit-based	Purchase credits, deducted per request
Real-time tracking	Monitor usage in the Developer Console
Deduplication	Same resource requested twice in 24 hours is only charged once

View pricing details →

---

Next steps

Get access

Sign up and create your first app.

Make your first request

Call the API in minutes.