# X 有官方 API 吗？

有：X 提供读取帖子、用户和搜索结果的官方 API，按调用量从预付额度扣费。SocialToAI 不需要 X 的开发者账号就能读它上面公开可见的帖子、评论、账号和热榜：20 个接口，每次调用 1 积分起（≈ $0.002–$0.0033），失败不扣。官方信息核对于 2026-10-17。

- 页面：https://socialtoai.com/zh/does-x-have-an-api/
- 最近更新：2026-10-29

## 简短的回答

有：X 提供读取帖子、用户和搜索结果的官方 API，按调用量从预付额度扣费。

## 官方 API 能做什么、限制在哪

X 提供官方 API，可读取帖子、用户和搜索结果。开发者在 X 开发者控制台注册即可使用，按调用量从预付额度中扣费；用量更大需申请企业方案。

来源：[X 官方的开发者文档](https://docs.x.com/x-api/getting-started/pricing)，核对于 2026-10-17。平台的规则会调整，以它自己的页面为准。

## X 官方的几种 API

| 官方 API | 谁能用、怎么开通 | 费用 | 限制 | 来源 |
| --- | --- | --- | --- | --- |
| X API（按量付费） | 任何开发者：在 X 开发者控制台注册，买预付额度。 | 每读一条帖子 $0.005，每读一个用户 $0.010，按返回的资源数扣。 | 每个账单周期最多读 300 万条帖子，再多要申请企业方案。X 注明价格可能调整。 | [docs.x.com](https://docs.x.com/x-api/getting-started/pricing)，核对于 2026-10-29 |

## 用 SocialToAI 读 X 的公开数据

SocialToAI 是读取公开可见内容和账号信息的 API 与 MCP 服务。你不需要 X 账号，也不用过应用审核：只要一把 SocialToAI 的 Key，或者在[Claude](https://socialtoai.com/zh/connect/claude.md)、[ChatGPT](https://socialtoai.com/zh/connect/chatgpt.md)、[Claude Code](https://socialtoai.com/zh/connect/claude-code.md)、[Cursor](https://socialtoai.com/zh/connect/cursor.md) 和[Codex](https://socialtoai.com/zh/connect/codex.md) 里登录。每次调用的积分固定，失败不扣。

| 接口 | 返回什么 | 价格键 | 积分 |
| --- | --- | --- | --- |
| [搜索](https://socialtoai.com/zh/x-search-api.md) | 按关键词找帖子：正文、作者、点赞数、评论数、播放或阅读数和发布时间。 | `x.search` | 2 |
| [搜索 · sort=latest](https://socialtoai.com/zh/x-search-api.md) | 按关键词找帖子：正文、作者、点赞数、评论数、播放或阅读数和发布时间。 | `x.search:latest` | 2 |
| [搜索 · type=user](https://socialtoai.com/zh/x-search-api.md) | 按关键词找账号：名称、简介、粉丝数、关注数和作品数。 | `x.search:user` | 5 |
| [热榜](https://socialtoai.com/zh/x-trending-api.md) | 现在的热榜：标题、名次和热度。 | `x.trending` | 6 |
| [详情](https://socialtoai.com/zh/x-detail-api.md) | 用编号或链接取一条帖子：正文、作者、点赞数、评论数、播放或阅读数和发布时间。 | `x.detail` | 1 |
| [评论](https://socialtoai.com/zh/x-comments-api.md) | 一条帖子下的评论：正文、点赞数、回复数和时间。 | `x.comments` | 2 |
| [账号资料](https://socialtoai.com/zh/x-user-profile-api.md) | 一个账号：名称、简介、粉丝数、关注数和作品数。 | `x.user_profile` | 1 |
| [账号作品](https://socialtoai.com/zh/x-user-posts-api.md) | 一个账号最近发布的帖子。 | `x.user_posts` | 2 |
| [社群资料](https://socialtoai.com/zh/x-community-api.md) | 按社群编号取 X 社群的资料。 | `x.community` | 1 |
| [社群帖子](https://socialtoai.com/zh/x-community-posts-api.md) | 按社群编号取一页这个 X 社群里的帖子。 | `x.community_posts` | 4 |
| [列表帖子](https://socialtoai.com/zh/x-list-posts-api.md) | 按列表编号取一页这个 X 列表时间线上的帖子，从最新的开始，每页约 100 条。 | `x.list_posts` | 2 |
| [长文详情](https://socialtoai.com/zh/x-article-api.md) | 按帖子编号取这条 X 帖子附带的长文。 | `x.article` | 2 |

另有 8 个，见 [X API 页](https://socialtoai.com/zh/platforms/x.md)。

**一次调用：搜索**

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

- 你这边不需要 X 账号、Cookie 或开发者审批。
- 返回的是平台上公开可见的内容；评论者一律匿名。
- 所有平台返回同一种格式，读 X 和读其他平台用同一套代码。
- 每次调用 1 积分起，预付积分；注册送 100 积分，不用绑卡。

## 不用官方 API，怎么采集 X 的公开数据

大致有三种办法，区别在于你要交出什么、要自己维护什么。下面说的是工具的类型，不是具体产品。

| 办法 | 你要准备什么 | 要注意什么 |
| --- | --- | --- |
| 自己写爬虫 | 代码、代理，常常还要你自己的 X 登录状态或 Cookie | 以你账号名义发出的请求可能被限流或封号；页面和签名会变，代码要一直维护。 |
| 在本机跑开源 MCP 或脚本 | 装好后用你的账号扫码登录，或贴上 Cookie | 它以你的账号去读；平台一改版、电脑一关机就停。 |
| 调用托管接口（SocialToAI） | 一把 SocialToAI 的 Key，或一个 MCP 地址加登录 | 不用你的账号；每次 1 积分起，失败不扣；跟上 X 的变化是我们的事。 |

## 常见问题

### 推特（X）API 多少钱？是每条 $0.005 吗？

是。X 按返回的资源数从预付额度扣费：每读一条帖子 $0.005，每读一个用户 $0.010，读一千条帖子就是 $5。来源：[docs.x.com](https://docs.x.com/x-api/getting-started/pricing)，核对于 2026-10-29。

### X API 读取有上限吗？

有：按量付费的方案每个账单周期最多读 300 万条帖子，超过要申请企业方案。来源：[docs.x.com](https://docs.x.com/x-api/getting-started/pricing)，核对于 2026-10-29。

### 不申请开发者账号，能读 X 吗？

能。SocialToAI 替你读 X 上公开可见的帖子、评论、账号和热榜：20 个接口，每次 1 积分起（约 ¥0.02），失败不扣。只要一把 SocialToAI 的 Key，或在 AI 客户端里登录。

### 这样采集 X 会封号吗？

不会牵连你的账号：全程不用你的 X 账号，不登录、不交 Cookie、不装任何东西，没有任何读取是以你的账号名义发生的。

### 在这里读 X 多少钱？

每次 1 积分起：按第一档约 $0.0033（约 ¥0.02），一千次约 $3.33。失败不扣，每次返回都写明扣了多少。注册送 100 积分，不用绑卡。

### Claude 和 ChatGPT 能读 X 吗？

能：在 Claude 或 ChatGPT 里添加 SocialToAI 的 MCP 地址，登录后点“允许”，然后用大白话问。每次回答都写明用了多少积分。

## 接着看

- [X 官方 API 太贵时，怎么让 AI 读 X](https://socialtoai.com/zh/how-to/read-x-when-the-official-api-is-too-expensive.md)：X 官方价格（带来源），以及改为按次读 X
- [X 官方 API 价格计算器](https://socialtoai.com/zh/free-tools/x-api-cost-calculator.md)：按你的用量算 X 官方 API 要多少钱。
- [各平台官方 API 价格和限制一览](https://socialtoai.com/zh/data/official-social-api-pricing.md)：所有平台的官方 API 一页看全，带来源。

## 来源

- [X: docs.x.com](https://docs.x.com/x-api/getting-started/pricing)，核对于 2026-10-17
- [SocialToAI 的 X API](https://socialtoai.com/zh/platforms/x.md)：每个调用和它的积分，最近实测 2026-10-17
- [实时目录](https://api.socialtoai.com/v1/capabilities)：此刻开放什么、各多少积分，不用 Key 就能读

- [X API](https://socialtoai.com/zh/platforms/x.md)：X 上的每个调用和可以照抄的请求。
- [X API 费用计算器](https://socialtoai.com/zh/free-tools/x-api-cost-calculator.md)：按 X 的价格和按次调用，各算一个月的花费。
- [X MCP 服务器](https://socialtoai.com/zh/mcp/x.md)：让你的 AI 直接读 X。
- [Claude](https://socialtoai.com/zh/connect/claude.md)：接入 Claude：登录即可，不用 Key。
- [ChatGPT](https://socialtoai.com/zh/connect/chatgpt.md)：接入 ChatGPT：登录即可，不用 Key。