推特 API 包含哪些数据?15 类数据逐项对照(2026)
按 15 类数据回答推特 API 包含哪些数据:搜索、时间线、回复、粉丝和列表两边都能读,别人的点赞、私信和书签都读不到,附 2026 年 11 月单价和实测。
Weir Team
发布于 · 更新于 · 阅读约 7 分钟
推特 API 包含推文、用户、粉丝、列表和 Spaces 等公开数据,但别人的点赞、私信和书签读不到。
这篇写给付钱之前想先确认“我要的数据拿不拿得到”的开发者。我们把 15 类数据逐项列出:X(推特)官方 API 有没有、单价多少,我们做的 Weir 有没有、扣几个积分。
想马上试一类数据,复制这条命令,换上你的 Key。它读一条推文的引用推文:
curl -s "https://api.weirapp.io/v1/x/posts/2120289321693630734/quotes?limit=5" \
-H "Authorization: Bearer $WEIR_API_KEY"

推特 API 是什么?
推特 API,也叫推特数据接口,是让程序读写 X 数据的入口。官方的叫 X API;X 的价格页写明,截至 2026 年 11 月 17 日它按量计费,没有订阅套餐。
第三方接口由别的公司提供,比如我们做的 Weir。它只读公开数据,不能发推,也不用申请开发者账号。
两边的完整价目,见推特 API 费用 2026。
推特 API 包含哪些数据?这 8 类两边都能读
下面 8 类是公开数据,官方 API 和 Weir 都能读。官方单价来自 X 的价格页,Weir 的积分来自我们的计费表:
| 数据 | X 官方 API | Weir |
|---|---|---|
| 按关键词搜推文 | $0.005/条 | 1 积分/条 |
| 一个账号的时间线 | $0.005/条 | 1 积分/条 |
| 推文下的回复 | $0.005/条 | 1 积分/条 |
| 引用推文 | $0.005/条 | 1 积分/条 |
| 转推的账号 | $0.010/个 | 1 积分/个 |
| 粉丝和关注列表 | $0.010/个 | 1 积分/个 |
| 列表和列表成员 | 列表 $0.005,成员 $0.010 | 列表 2 积分,成员 1 |
| Spaces 语音直播间 | $0.005/个 | 2 积分/个 |
Weir 每次成功的调用另收 1 积分。时间线、粉丝和关注的第一页,再加 2 积分查一次账号资料。
动手之前,先看清三处不同:
- 官方没有专门的回复接口。 要用搜索加
conversation_id:运算符;最近搜索只查 7 天,更早的要用全量搜索。 - Weir 的时间线只到最新约 800 条。 更早的推文用搜索加日期,写法见推特搜索 API 教程。
- 通过 Weir 读粉丝和列表推文,每页条数由 X 决定。 粉丝一页最多约 70 个,列表推文最多约 100 条。
这 7 类数据要看情况
剩下 7 类,有的只有一边能读,有的谁都读不到:
| 数据 | X 官方 API | Weir |
|---|---|---|
| X 文章(Articles) | 有,按推文 $0.005 | 有,1 积分/篇 |
| 推文编辑历史 | 有,每个版本 $0.005 | 有,每个版本 1 积分 |
| “关于此账号”信息 | 没有对应字段 | 有,2 积分/个 |
| 趋势(热搜) | 有,$0.010/次 | 没有 |
| 别人点赞的推文 | 读不到 | 读不到 |
| 别人的私信 | 读不到 | 读不到 |
| 别人的书签 | 读不到 | 读不到 |
X 文章和编辑历史,官方放在推文对象的两个字段里:article 和 edit_history_tweet_ids。Weir 给的是两个单独的接口。
“关于此账号”是资料页上的一块信息:账号所在国家或地区、怎么连接 X、改过几次用户名。X 的数据字典里,用户对象没有这些字段,只有用户自己填的 location。
趋势只有官方有。它按地点编号 WOEID 读取,一次最多 50 条,每次 $0.010。
Weir 没有趋势接口。想知道一个话题热不热,可以用推文计数器数一数它有多少推文。
为什么别人的点赞、私信和书签读不到?
因为 X 把它们设成了只有本人能看。
点赞是 2024 年 6 月 12 日改的。X 的工程账号 @Engineering 那天发帖:“Starting today, Likes are private for everyone.”意思是从今天起,所有人的点赞都是私密的。
前一天的说明更细:你还能看到自己赞过的推文,别人看不到;作者能看到谁赞了自己的推文。我们在 2026 年 11 月 17 日用 Weir 读了这两条帖子。
私信和书签本来就是私密的。官方 API 只让你读自己账号的,而且要你本人用 OAuth 授权。点赞读取接口也要本人授权。
X 的价格页把读自己的书签和点赞算作“自有数据读取”(Owned Reads),$0.001 一条。读一条私信事件是 $0.010。
Weir 只读公开数据,这三样都没有。
我们实测了 5 个接口,都拿到了数据
2026 年 11 月 17 日,我们用 Weir 的研究账号调了 5 次,只读品牌账号,一共扣了 19 积分:

有三点出乎我们意料:
- 搜索结果里有转推。 我们加了
onlyOriginal,5 条里还有 3 条转推,因为它只排除回复。要去掉转推,在query里加-filter:nativeretweets。 - 引用数对得上。 那条推文显示被引用 4 次,引用接口正好返回 4 条。它们都来自个人账号,所以我们只报数量。
- “关于此账号”读到了。 @XDevelopers 显示在美国,通过网页(Web)连接,改过 1 次用户名。
推特数据接口怎么用?
用 Weir 的话,从注册到拿到第一批数据只要三步:
- 注册拿 Key在 weirapp.io 免费注册,不用绑卡。
- 发一次请求运行开头的 curl,或在 AI 应用里连上 Weir 的 MCP。
- 看扣了多少响应头 x-credits-charged 写着这次扣的积分。
要更多数据就翻页:把 meta.nextCursor 原样传回 cursor,直到它变成 null。每页单独计费,所以循环要设页数上限。
不写代码也行。在接好 Weir 的 AI 应用(比如 Claude)里粘贴:
用 Weir 查 @XDevelopers 最新一条原创推文被引用了几次,并告诉我这次一共扣了多少积分。
我们 11 月 17 日用同样两步(search_x 加 get_x_quotes)跑过:最新一条发于 11 月 10 日,被引用 4 次,共扣 11 积分。
读 20 条推文扣 21 积分;每月 5,000 积分免费;$5 可买 25,000 积分。免费额度够读多少,见推特 API 免费额度。
读 1,000 条数据要多少钱?
按 2026 年 11 月 17 日的价格,同样读 1,000 条:
Weir 一页约 20 条,1,000 条要 50 次调用,共 1,050 积分,按 $5 套餐的单价约 $0.21。各家每 1,000 条的价格,我们整理在 X API 价格指数里。
X 那边,同一个 UTC 日内重复读同一条数据只收一次钱。它的文档还有一个未合并的改动(PR #520):计划从 2026 年 11 月 22 日起,expansions 带回的作者和媒体也按条计费,见 expansions 计费说明。
什么时候不适合用 Weir
- 你要发推、发私信或管理列表。 Weir 只读,这些要用官方 API。
- 你要趋势数据。 Weir 没有趋势接口,官方每次 $0.010。
- 你只读自己账号的数据。 官方的自有数据读取 $0.001 一条,还能读你的书签和点赞。
- 你的项目必须用官方授权的数据。 Weir 与 X 没有关联,也没有 X 的授权,访问方式可能变化。
想比较更多第三方接口,看推特 API 替代方案。
常见问题
推特 API 是什么?
推特 API 是让程序读写 X 数据的接口。截至 2026 年 11 月 17 日,官方 X API 读一条推文 $0.005。Weir 这类第三方接口只读公开数据,每月 5,000 积分免费。
X API 可以做什么?
能读推文、用户、粉丝、列表、Spaces 和趋势,也能发推、发私信、管理列表。按 X 的价格页,发一条推文 $0.015,带链接的 $0.200。
推特 API 能看到别人点赞了哪些推文吗?
不能。X 从 2024 年 6 月 12 日起把点赞设为私密,只有你自己能看到你赞过什么。Weir 也读不到点赞列表,只能读到点赞数。
推特 API 能读私信吗?
只能读你自己账号的,要你本人用 OAuth 授权,每条私信事件 $0.010。别人的私信,哪家 API 都读不到。
推特 API 有热搜趋势数据吗?
官方有:按地点编号 WOEID 读取,一次最多 50 条,每次 $0.010。Weir 没有趋势接口。
参考来源
以下均于 2026 年 11 月 17 日核对,均为英文页面:
- X API 价格页:https://docs.x.com/x-api/getting-started/pricing
- X API 搜索介绍:https://docs.x.com/x-api/posts/search/introduction
- X API 搜索运算符:https://docs.x.com/x-api/posts/search/integrate/operators
- X API 数据字典:https://docs.x.com/x-api/fundamentals/data-dictionary
- X API 编辑推文:https://docs.x.com/x-api/fundamentals/edit-posts
- X API 趋势(WOEID):https://docs.x.com/x-api/trends/get-trends-by-woeid
- X API 书签:https://docs.x.com/x-api/users/get-bookmarks
- X API 私信事件:https://docs.x.com/x-api/direct-messages/get-dm-events
- X API 点赞读取:https://docs.x.com/x-api/users/get-liked-posts
- X 文档 PR #520(未合并):https://github.com/xdevplatform/docs/pull/520
- X @Engineering,2024 年 6 月 11 日和 12 日(经 Weir 读取):https://x.com/Engineering/status/1800634371906380067 和 https://x.com/Engineering/status/1800959499932496139
- Weir API 参考与计费:https://docs.weirapp.io/reference/x/searchX 和 https://docs.weirapp.io/billing
- Weir 调用,2026 年 11 月 17 日:5 次,共 19 积分