X API 价格调整:expansions 计费 11 月 22 日起
X API 价格调整:11 月 22 日起,expansions 返回的用户和媒体也要按量计费。100 条推文从 $0.50 变成 $1.30,附每项单价、省钱办法和更省的读取方案。
Weir Team
发布于 · 更新于 · 阅读约 6 分钟 · Read in English · 日本語で読む
X API 价格调整:从 2026 年 11 月 22 日起,expansions 返回的对象也要计费。
以前只收推文的钱,现在 includes 里的作者、图片、投票和地点都按正常单价收。一条带新作者的推文,从 $0.005 变成 $0.015。
这篇写给用 X(推特)按量付费 API、代码里带 expansions= 参数的开发者。你会看到新单价、常见调用的账单、省钱办法和更便宜的读取路线。我们做 Weir,一个读取公开推特数据的 API,用到时会说明。
下面这个请求同时要了作者和媒体(我们没有 X 的密钥,所以没有运行,写法照 X 文档):
curl "https://api.x.com/2/tweets/search/recent?query=from:NASA&max_results=100&expansions=author_id,attachments.media_keys" \
-H "Authorization: Bearer $TOKEN"
推特 API 按量付费:11 月 22 日起 expansions 怎么计费?
X 为 11 月 22 日准备的更新日志写的是“Expansion objects now count toward usage.”,意思是响应里的 includes 部分也算用量,不只是 data。
我们在 2026 年 11 月 16 日读了原始来源:X 文档仓库的第 520 号拉取请求(PR),2026 年 10 月 28 日提交。它的横幅写着:等 expansions 计费在生产环境启用(计划 11 月 22 日)后才能合并。
X 还在开发者论坛发了一条通知,标题是“[Inform] X API PPU - Expansions Update”。论坛对自动程序返回 403,我们没有打开,所有数字都取自这个 PR。
PR 里的单价如下:
- 推文 $0.005,用户 $0.010,每个对象,价格不变。
- 媒体、投票、地点、话题 各 $0.005,这是新增的读取价格。
- 一条推文带 4 张图片就是 4 个媒体对象,收 4 次。
X API 11 月 22 日涨价:一个真实请求要多少钱?
每个对象算一次,账单就是加法。
11 月 22 日之前,同样的请求只收推文的钱。
| 请求 | 11 月 22 日前 | 11 月 22 日后 |
|---|---|---|
| 100 条推文,不带 expansions | $0.50 | $0.50 |
100 条推文 + author_id,60 个作者 |
$0.50 | $1.10 |
同上 + attachments.media_keys,40 媒体 |
$0.50 | $1.30 |
| 读自己的 100 条推文,1 个用户,30 媒体 | $0.10 | $0.131 |
第三行的算式是 100 × $0.005 + 60 × $0.010 + 40 × $0.005,等于 $1.30,正是 X 在 PR 里给的算例。第二行是 $0.50 加 $0.60。
最后一行是“自有读取”(Owned Reads),指用你自己的应用读自己的推文、提及和点赞。这类请求里的 expansions 对象只收 $0.001,131 个对象共 $0.131。用 OAuth 读别人的数据不算自有读取。
X 官方文档现在怎么写?
2026 年 11 月 16 日,线上价格页(11 月 13 日更新)列的是读推文 $0.005、读用户 $0.010。页面上还没有媒体、投票、地点的读取行,也没有 expansions 一节。
线上的 expansions 页面也没有计费说明,只写着 expansions 可以“在一次 API 响应里包含相关对象”。
所以在 PR 合并之前,新规则不会出现在 X 的公开文档里。把 PR 和论坛通知当作计划,11 月 22 日当天去开发者控制台核对账单。完整价目表见我们的推特 API 费用 2026。
怎么少花钱?
多出来的钱,大部分是用户。
带 author_id 的请求,每条推文最多多出一个 $0.010 的用户,所以先从这里省。
- 不读的 expansions 就不要。PR 里 X 自己的建议:只请求应用用得上的。
- 已经知道作者就别要
author_id。用from:搜索时,每条推文的作者都是同一个账号。 - 用户资料缓存一天。读缓存不花钱,X 的去重在同一个 UTC 日内也是这个效果。
- 盯着开发者控制台。拿一天的花费,对照上面的算式。
想知道一个响应要多少钱,数一数里面的对象。这段代码没有运行过,因为我们没有 X API 密钥:
import json
def estimate(resp: dict) -> float:
inc = resp.get("includes", {})
cost = 0.005 * len(resp.get("data", []))
cost += 0.010 * len(inc.get("users", []))
for kind in ("media", "polls", "places", "tweets"):
cost += 0.005 * len(inc.get(kind, []))
return round(cost, 4)
print(estimate(json.load(open("response.json"))))
它没有算去重,所以是上限。你的赠送额度也会影响实际花费:一次性的 $20 和同额匹配,见X API 免费额度。
有没有比 X API expansions 更便宜的路线?
Weir 是一条。在 Weir 上,搜索结果里每条推文都自带作者,作者不另外收费。一条推文 1 积分,每次调用另加 1 积分。
2026 年 11 月 16 日,我们用 search_x 搜 @NASA 的推文,limit 设为 20,返回 20 条推文,花了 21 积分。
{
"id": "2121280846183137564",
"createdAt": "2026-11-13T16:35:39.000Z",
"author": {
"username": "NASA",
"name": "NASA",
"verified": true,
"followersCount": 92250508
},
"likeCount": 5169,
"media": [{ "type": "photo" }]
}
响应的 meta 里是 creditsCharged: 21。媒体列表也跟着推文一起返回。20 条里有 11 条是转推,每条都带着原作者,来自另外 7 个账号。
再算 100 条:5 页,每页 20 条,共 105 积分。按 $5 套餐(25,000 积分)算是 $0.021,按 $20 套餐(120,000 积分)算是 $0.0175。
同样 100 条带作者的推文,Weir 比 X 的 $1.30 算例便宜约 60 倍。其他方案的对比见X API 价格指数,也可以在推特 API 费用计算器里填你自己的用量。
Weir 每月前 5,000 积分免费,不用绑卡,价格见Weir 价格页。
什么时候不适合用 Weir
- 你需要发推、回复或点赞。Weir 只读,写入只能走 X 官方 API。
- 你需要自己账号的私有数据。书签、私信和后台分析要用你自己的 X 登录,Weir 只读公开数据。
- 合同或合规要求写明用 X。Weir 没有 X 的授权,访问方式可能变化。请看适用于你的条款,这不是法律建议。
- 你需要全量数据流。每天几百万条推文是另一个量级,向 X 或企业级数据商询价更合适。
常见问题
X API 价格调整后,我的账单会涨吗?
只有请求里带 expansions 才会涨。2026 年 11 月 22 日起,X 对 includes 里的每个对象收费:用户 $0.010,推文、媒体、投票、地点各 $0.005。不带 expansions 的请求,价格和以前一样。
推特 API 的 author_id expansions 要额外收费吗?
要,从 2026 年 11 月 22 日起。includes.users 里每个不同的作者算一次 $0.010 的用户读取。推文自带的 author_id 字段只是一个 id,不另外收费。
一条带 4 张图片的推文,媒体怎么收费?
收 4 次。X 的 PR 写明每个媒体对象单独计费,每个 $0.005,4 张图片共 $0.020。去重仍然有效:同一个媒体键在同一个 UTC 日再次返回,不会重复收费。
推特API 费用里的 expansions 怎么避免?
只请求你用得上的 expansions。作者资料缓存一天,再盯着开发者控制台。也可以换成每条推文自带作者的来源,比如 Weir,每条推文 1 积分。余额不足时的报错见X API 错误码。
参考来源
以下均查看于 2026 年 11 月 16 日:
- X 文档仓库第 520 号 PR,“PPU: document expansion billing (media/poll/place rates, owned reads, dedup)”,2026 年 10 月 28 日提交(英文):https://github.com/xdevplatform/docs/pull/520
- X 开发者论坛,“[Inform] X API PPU - Expansions Update”(英文,对自动程序返回 403,未打开):https://devcommunity.x.com/t/inform-x-api-ppu-expansions-update/279110
- X API 价格页,2026 年 11 月 13 日更新(英文):https://docs.x.com/x-api/getting-started/pricing
- X API expansions 页面,2026 年 11 月 13 日更新(英文):https://docs.x.com/x-api/fundamentals/expansions
- Weir 价格和套餐(英文):https://weirapp.io/buy
- 我们通过 Weir 搜索 @NASA,2026 年 11 月 16 日:20 条推文,21 积分