> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-docs-media-upload-16gb-segments.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# About the X API

> High-level overview of the X API covering capabilities, v2 versus v1.1 versions, available resources, pricing tiers, and how to start building.

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

<Tabs>
  <Tab title="X API v2 (Recommended)">
    The current version of the X API with modern features and flexible pricing.

    **Why use v2:**

    * Pay-per-usage pricing
    * Modern JSON response format
    * Flexible [fields](/x-api/fundamentals/fields) and [expansions](/x-api/fundamentals/expansions)
    * Advanced features: annotations, conversation tracking, edit history
    * All new endpoints and features

    **Getting started:**

    1. Sign up at [console.x.com](https://console.x.com)
    2. Create an app and get credentials
    3. [Make your first request](/x-api/getting-started/make-your-first-request)
  </Tab>

  <Tab title="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](/x-api/migrate/overview) for endpoint mapping and data format changes.
  </Tab>
</Tabs>

***

## Available resources

The X API provides access to these resource types:

<CardGroup cols={3}>
  <Card title="Posts" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/i3YU85t7KinoXPCP/icons/xds/icon-chat.svg?fit=max&auto=format&n=i3YU85t7KinoXPCP&q=85&s=05a8ee5b9e8ea26218692b95408eb073" width="24" height="24" data-path="icons/xds/icon-chat.svg">
    Search, retrieve, create, and delete posts. Access timelines, threads, and quote posts.
  </Card>

  <Card title="Users" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/2ddhYrNu_7iz4e30/icons/xds/icon-person.svg?fit=max&auto=format&n=2ddhYrNu_7iz4e30&q=85&s=5b5713b5eb189895278db1475c8e721b" width="24" height="24" data-path="icons/xds/icon-person.svg">
    Look up profiles, manage relationships, and access follower data.
  </Card>

  <Card title="Spaces" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/2ddhYrNu_7iz4e30/icons/xds/icon-microphone.svg?fit=max&auto=format&n=2ddhYrNu_7iz4e30&q=85&s=655ff81b58c70fba6edf8f52ae284a58" width="24" height="24" data-path="icons/xds/icon-microphone.svg">
    Discover live audio conversations and participants.
  </Card>

  <Card title="Direct Messages" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/9de4WJMp2N1M6prx/icons/xds/icon-envelope.svg?fit=max&auto=format&n=9de4WJMp2N1M6prx&q=85&s=ebb6ac4155efe8b809df57a5df5cc078" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    Send and receive private messages between users.
  </Card>

  <Card title="Lists" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/i3YU85t7KinoXPCP/icons/xds/icon-bulleted-list.svg?fit=max&auto=format&n=i3YU85t7KinoXPCP&q=85&s=4a7b40694549217c1ebe7f31e98ec041" width="24" height="24" data-path="icons/xds/icon-bulleted-list.svg">
    Create and manage curated lists of accounts.
  </Card>

  <Card title="Trends" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/9de4WJMp2N1M6prx/icons/xds/icon-feather-chart-line.svg?fit=max&auto=format&n=9de4WJMp2N1M6prx&q=85&s=f627ed1de7c393a6504eaceb958cb46f" width="24" height="24" data-path="icons/xds/icon-feather-chart-line.svg">
    Access trending topics by location.
  </Card>
</CardGroup>

***

## v2 highlights

<Accordion title="Fields and expansions">
  Request only the data you need. Use `fields` parameters to select specific attributes and `expansions` to include related objects.

  ```bash theme={null}
  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 →](/x-api/fundamentals/fields)
</Accordion>

<Accordion title="Post annotations">
  Posts include semantic annotations identifying people, places, products, and topics. Filter streams and searches by topic.

  [Learn more about annotations →](/x-api/fundamentals/post-annotations)
</Accordion>

<Accordion title="Engagement metrics">
  Access public metrics (likes, reposts, replies) and private metrics (impressions, clicks) for your own posts.

  [Learn more about metrics →](/x-api/fundamentals/metrics)
</Accordion>

<Accordion title="Conversation tracking">
  Reconstruct entire conversation threads using `conversation_id`. Track replies across the full thread.

  [Learn more about conversation tracking →](/x-api/fundamentals/conversation-id)
</Accordion>

<Accordion title="Edit history">
  Access the edit history of posts, including all previous versions and edit metadata.

  [Learn more about edit posts →](/x-api/fundamentals/edit-posts)
</Accordion>

***

## Pricing

X API v2 uses **pay-per-usage** pricing:

| Benefit | Description |
| :- | :- |
| **No subscriptions** | Pay only for what you use |
| **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 →](/x-api/getting-started/pricing)

***

## Next steps

<CardGroup cols={2}>
  <Card title="Get access" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/2ddhYrNu_7iz4e30/icons/xds/icon-key.svg?fit=max&auto=format&n=2ddhYrNu_7iz4e30&q=85&s=ec4d8ecc66dff3c785b02e3788ab26f3" href="/x-api/getting-started/getting-access" width="24" height="24" data-path="icons/xds/icon-key.svg">
    Sign up and create your first app.
  </Card>

  <Card title="Make your first request" icon="https://mintcdn.com/x-preview-docs-media-upload-16gb-segments/4udm0z6UKcSt-TPm/icons/xds/icon-rocket.svg?fit=max&auto=format&n=4udm0z6UKcSt-TPm&q=85&s=9909f26438b2bea6cba4aba5320a967b" href="/x-api/getting-started/make-your-first-request" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Call the API in minutes.
  </Card>
</CardGroup>