WEIR

X API 价格调整:expansions 计费 11 月 22 日起

X API 价格调整:11 月 22 日起,expansions 返回的用户和媒体也要按量计费。100 条推文从 $0.50 变成 $1.30,附每项单价、省钱办法和更省的读取方案。


发布于 · 更新于 · 阅读约 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"
$0.50100 条推文,22 日前
$1.30同一个请求,带作者和媒体
$0.001读自己的推文时,每个 expansions 对象

推特 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 条带作者的推文,美元
X API 11 月 22 日后(60 作者、40 媒体)$1.30
X API 11 月 22 日后(只加作者)$1.10
X API 只要 100 条推文$0.50
Weir,$5 套餐$0.021
Weir,$20 套餐$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 日: