---
title: "X (Twitter) API: 20 Posts for $0.0067 · SocialToAI"
canonical: https://socialtoai.app/platforms/x/
updated: 2026-11-01
---

# X (Twitter) API

The X (Twitter) API lets you search posts and read post details, comments, account profiles, an account's posts and the trending list, with no X account or login. Calls cost 1 to 6 credits each (from $0.002); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/x/
- Last updated: 2026-11-01
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find posts by keyword: text, author, likes, comment count, views and publish time. | — | `x.search` | 2 | [X (Twitter) Search API](https://socialtoai.app/x-search-api.md) |
| `search` | newest first | `sort=latest` | `x.search:latest` | 2 | [X (Twitter) Search API](https://socialtoai.app/x-search-api.md) |
| `search` | accounts instead of posts | `type=user` | `x.search:user` | 5 | [X (Twitter) Search API](https://socialtoai.app/x-search-api.md) |
| `trending` | What is trending now: title, rank and heat. | — | `x.trending` | 6 | [X (Twitter) Trending API](https://socialtoai.app/x-trending-api.md) |
| `detail` | One post by ID or link: text, author, likes, comment count, views and publish time. | — | `x.detail` | 1 | [X (Twitter) Detail API](https://socialtoai.app/x-detail-api.md) |
| `detail` | the transcript of the video | `include=transcript` | `x.detail:transcript` | 2 | [X (Twitter) Detail API](https://socialtoai.app/x-detail-api.md) |
| `comments` | The comments under one post: text, likes, reply count and time. | — | `x.comments` | 2 | [X (Twitter) Comments API](https://socialtoai.app/x-comments-api.md) |
| `user_profile` | One account: name, bio, followers, following and post count. | — | `x.user_profile` | 1 | [X (Twitter) User Profile API](https://socialtoai.app/x-user-profile-api.md) |
| `user_posts` | The recent posts of one account. | — | `x.user_posts` | 2 | [X (Twitter) User Posts API](https://socialtoai.app/x-user-posts-api.md) |

Compared with Reddit: X posts also give author followers, saves, reposts, views and hashtags but do not give title or shares; its accounts also give followers and following.

Lighter for your AI: across 21 interfaces measured on the same recorded data, the platform's raw JSON is about 247,096 tokens and SocialToAI's answers about 88,867, 64% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "x",
    "query": "weather forecast"
  }'
```

## Only on X

Each one is called by its own op, through `POST /v1/call/{op}`; its full parameters and response fields are on its own page.

### Communities and lists

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Community profile | Get an X community by its ID. | `x.community` | 1 | [X (Twitter) community profile API](https://socialtoai.app/x-community-api.md) |
| Community posts | Get a page of the posts in an X community by the community's ID. | `x.community_posts` | 4 | [X (Twitter) community posts API](https://socialtoai.app/x-community-posts-api.md) |
| List posts | Get a page of the posts on an X list's timeline by the list's ID, newest first, about 100 a page. | `x.list_posts` | 2 | [X (Twitter) list posts API](https://socialtoai.app/x-list-posts-api.md) |
| Community members | Get a page of the accounts that have joined an X community, by the community's ID, about 20 a page. | `x.community_members` | 5 | [X (Twitter) community members API](https://socialtoai.app/x-community-members-api.md) |
| List followers | Get accounts that follow an X list, by the list's ID, up to 20. | `x.list_followers` | 5 | [X (Twitter) list followers API](https://socialtoai.app/x-list-followers-api.md) |
| List members | Get a page of the accounts an X list is made of, by the list's ID, 20 a page. | `x.list_members` | 5 | [X (Twitter) list members API](https://socialtoai.app/x-list-members-api.md) |

### Content and accounts

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Article detail | Get the long-form article attached to an X post by the post's ID. | `x.article` | 2 | [X (Twitter) article detail API](https://socialtoai.app/x-article-api.md) |
| Post quotes | Get a page of the X posts that quote a post, newest first or most popular first. | `x.quotes` | 4 | [X (Twitter) post quotes API](https://socialtoai.app/x-quotes-api.md) |
| Post retweeters | Get a page of the accounts that retweeted an X post, by the post's ID. | `x.retweeters` | 2 | [X (Twitter) post retweeters API](https://socialtoai.app/x-retweeters-api.md) |
| Thread context | Get the posts of an X thread by the ID of any post in it. | `x.thread` | 9 | [X (Twitter) thread context API](https://socialtoai.app/x-thread-api.md) |
| User followers | Get a page of the accounts following an X user, up to 200 a page, newest followers first. | `x.followers` | 12 | [X (Twitter) user followers API](https://socialtoai.app/x-followers-api.md) |
| User following | Get a page of the accounts an X user follows, up to 200 a page. | `x.following` | 12 | [X (Twitter) user following API](https://socialtoai.app/x-following-api.md) |
| User mentions | Get a page of the posts that mention an X user, newest first. | `x.mentions` | 4 | [X (Twitter) user mentions API](https://socialtoai.app/x-mentions-api.md) |

## Fields X cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `title` | search, detail, user_posts |
| `metrics.shares` | search, detail, user_posts |
| `is_pinned` | search, detail, user_posts |
| `id` | trending |
| `heat` | trending |
| `url` | trending |
| `parent_id` | comments |
| `root_id` | comments |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Search 1,000 results on X | usually 20 a page, 50 pages | 100 credits | about $0.33 |
| Read 1,000 X comments | usually 35 a page, 29 pages | 58 credits | about $0.19 |
| Backfill one X account: a list of 200 posts and 20 in full | 10 list pages + 20 full reads | 40 credits | about $0.13 |
| Watch 1 X account daily, at most a month | 9 credits × 31 days | 279 credits | about $0.93 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on X this week: home coffee or matcha? → search, search: 4 credits

- Read the comments on this X post and tell me what people complain about. → detail, comments × 3: 7 credits

- Find five X accounts that post about camping coffee and show me what they posted lately. → search, user_posts × 5: 15 credits

[X (Twitter) MCP Server](https://socialtoai.app/mcp/x.md)

## Ready-made tools that read X

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Comment analysis](https://socialtoai.app/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Find creators](https://socialtoai.app/tools/find-creators.md): Creators who make that content, with their size, recent posts and how well each fits
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked
- [Viral finder](https://socialtoai.app/tools/viral-finder.md): Posts that did clearly better than their authors usually do

## Official API

X offers an official API for posts, users and search. Developers sign up in the X developer console and pay per use with prepaid credits; higher volumes need an Enterprise plan.

Source: [X's developer documentation](https://docs.x.com/x-api/getting-started/pricing), checked 2026-10-17.

|  | Who can use it | Cost | Limits | Source |
| --- | --- | --- | --- | --- |
| X API, pay per use | Any developer: sign up in the X developer console and buy prepaid credits. | $0.005 per post read, $0.010 per user read, charged per resource returned. | Up to 3 million post reads per billing cycle; more needs an Enterprise plan. X says prices may change. | [docs.x.com](https://docs.x.com/x-api/getting-started/pricing), checked 2026-10-29 |
| SocialToAI | Anyone with a key; no X account of yours and no review. | From 1 credit a call (≈$0.0033); failed calls are free. | Publicly visible content only; up to 60 items a call. | https://socialtoai.app/pricing.md |

1,000 posts here: about 50 `x.search` calls (typically 20 a page), 100 credits, $0.33 at the first pack; at X's own $0.005 a post they are $5. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[X official API: access, prices and limits](https://socialtoai.app/does-x-have-an-api.md)

- [Comments API, every platform](https://socialtoai.app/comments-api.md): Which platforms give comments, how many a page, at what price.
- [Transcript API, every platform](https://socialtoai.app/transcript-api.md): Which platforms give a transcript, timed or not.
- [How to let AI read X when the official API is too expensive](https://socialtoai.app/how-to/read-x-when-the-official-api-is-too-expensive.md): X's official prices, with sources, and reading X per call instead
- [How to analyze video comments with AI, and keep the original words](https://socialtoai.app/how-to/analyze-comments-with-quotes.md): what comments say, with original words: the tool or your AI, price per platform, a recorded answer
- [How to get the numbers for hundreds of post links at once](https://socialtoai.app/how-to/check-stats-for-many-links.md): the numbers of hundreds of links in one job: prices per platform, what the free credits run, and what it stops for
- [How to search X by date with since and until](https://socialtoai.app/how-to/search-x-by-date.md): since and until, as parameters or in the query, tested, with what a month of posts costs
- [Monitor X (Twitter) every day: what it really costs](https://socialtoai.app/monitors/x.md): an X keyword or account, daily, 2 credits a run, with the month worked out against X's own price
- [Monitor competitors' accounts every day](https://socialtoai.app/monitors/competitors.md): competitors' accounts, daily: what is new and what beat their usual, from 9 credits an account
- [Monitor brand mentions every day, with the posts behind them](https://socialtoai.app/monitors/brand.md): a brand, daily, across platforms: attitudes and the posts behind them, from 16 credits a run
- [X (Twitter) trending today](https://socialtoai.app/trending/x.md): Today's board in one list, refreshed daily.
- [X (Twitter) MCP server](https://socialtoai.app/mcp/x.md): Let your AI read X.

[X API cost calculator](https://socialtoai.app/free-tools/x-api-cost-calculator.md): A month of reads at X's prices, and per call.
