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

# Introduction

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

The X API enables programmatic access to X in unique and advanced ways. Tap into core elements of X like: Posts, Direct Messages, Spaces, Lists, users, and more.

<div className="flex space-x-2.5">
  <Button href="https://developer.x.com/en/portal/products/pro">
    Subscribe to Pro access
  </Button>

  <Button href="/x-api/getting-started/about-x-api">
    API access levels and versions
  </Button>
</div>

***

## X API v2

X API v2 is ready for prime time! We recommend that the majority of developers start to think about migrating to v2 of the API, and for any new users to get started with v2. Why migrate?

<CardGroup cols="2">
  <Card title="New and more detailed data objects" icon="database" href="/x-api/fundamentals/data-dictionary" />

  <Card title="New parameters to request objects and fields" icon="sliders" href="/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions" />

  <Card title="Advanced metrics" icon="chart-pie" href="/x-api/fundamentals/metrics" />

  <Card title="Receive and filter data with contextual post annotations" icon="comment-dots" href="/x-api/fundamentals/post-annotations" />

  <Card title="Filter on and identify which posts belong to a reply thread" icon="reply" href="/x-api/fundamentals/conversation-id" />

  <Card title="And much more..." icon="plus" href="/x-api/getting-started/about-x-api" />
</CardGroup>

## Access Levels

### Free

* For write-only use cases and testing the X API
* Low rate-limit access to v2 posts and media upload endpoints
* 500 Posts per month - posting limit at the app level
* 1 Project, 1 App per Project, 1 Environment
* Login with X, Access to Ads API
* Cost: Free

### Basic

* For hobbyists or prototypes
* Low-rate limit access to suite of v2 endpoints
* 3,000 Posts per month (user level), 50,000 Posts per month (app level)
* 10,000/month Posts read-limit rate cap
* 1 Project, 2 Apps per Project
* Login with X, Access to Ads API
* Cost: \$200 per month

### Pro

* For startups scaling their business
* Rate-limited access to suite of v2 endpoints, including search and filtered stream
* 1,000,000 Posts per month - GET at the app level
* 300,000 Posts per month - posting limit at the app level
* 1 Project, 3 Apps per Project
* Login with X, Access to Ads API
* Cost: \$5,000 per month

### Enterprise

* For businesses and scaled commercial projects
* Commercial-level access that meets your and your customer's specific needs
* Managed services by a dedicated account team
* Complete streams: replay, engagement metrics, backfill, and more features
* Cost: Monthly subscription tiers

<Button href="/x-api/getting-started/about-x-api">
  More on v2 access levels
</Button>

## Migrate to X API v2

Interested in migrating your current integration to X API v2? Check out our migration hub for resources that will help you understand what is different between v2 and previous versions, including the data formats. You can also access migration guides for each endpoint listed in the new v2 endpoint sections.

<div className="flex space-x-2.5">
  <Button href="/x-api/migrate/overview">
    Learn more
  </Button>

  <Button href="/x-api/migrate/x-api-endpoint-map">
    X API endpoint map
  </Button>
</div>

***

## What to build

Check out our 'what to build" page to learn more about:

* Moderate conversations for health and safety
* Enable creation and personal expression
* Measure and analyze "what's happening"
* Improve community experiences
* Curate and recommend content
* Impact the greater good

<Button href="/x-api/what-to-build">
  What to build
</Button>

## Tools to get you started

Go from zero to "Hello World" with the help of these resources, tools, and libraries.

<CardGroup cols="1">
  <Card title="Client libraries" icon="screwdriver-wrench">
    Check out our curated selection of all X-built and community-supported client libraries.

    <br />

    [Browse libraries](/x-api/tools-and-libraries/overview)
  </Card>

  <Card title="v2 Postman collection" icon="book">
    We have built out a Postman collection for our v2 endpoints to help you explore the API using their visual client!

    <br />

    [Get started with Postman](https://app.getpostman.com/run-collection/9956214-784efcda-ed4c-4491-a4c0-a26470a67400)
  </Card>

  <Card title="Sample code" icon="code">
    Looking to get started building with the X API. We have sample code, clients, and other example apps available. Check out the @XDevelopers GitHub!

    <br />

    [Get started with our sample code](https://github.com/xdevplatform)
  </Card>
</CardGroup>

## Need help?

Visit our support section for troubleshooting tips, FAQs, live API status monitor, and other helpful information.

<Button href="https://developer.x.com/en/support/twitter-api.html">
  Get support
</Button>

## Join the conversation

Explore our forum created for developers building and innovating on the X Developer Platform.

<Button href="https://devcommunity.x.com/">
  Check our forum
</Button>