X API 料金 改定:expansions 課金が 11月22日 開始
X API 料金 改定で、11月22日から expansions の返す author や media にも従量課金がかかります。100 ポスト $0.50 が $1.30 になる例と、減らし方を整理。
Weir Team
公開 · 更新 · 約 7 分で読めます · Read in English · 阅读中文版
X API の料金改定で、2026 年 11 月 22 日から expansions で返るオブジェクトにも従量課金がかかります。
includes に入る著者や画像が、1 件ずつ課金されます。新しい著者つきのポストは、$0.005 ではなく $0.015 です。
対象は、従量課金の X(旧 Twitter)API で expansions= を付けているコードです。新しい単価、よくある呼び出しの金額、減らし方、安く読む方法を順に書きます。私たちは X のデータ API「Weir」を運営しているので、その点は明記します。金額はすべて米ドルです。
著者とメディアを返してもらう呼び出しは、次のようになります。X の公式ドキュメントどおりに書いたもので、私たちは X の API キーを持たないため実行していません。
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"
X API の expansions 課金は何が変わる?
X が 11 月 22 日に向けて用意した更新履歴の文言は「Expansion objects now count toward usage.」です。レスポンスの data だけでなく、includes の中身も使用量に数えるという意味です。
2026 年 11 月 16 日に、X の docs リポジトリのプルリクエスト 520 を読みました。10 月 28 日に作られたもので、バナーには「本番で expansion 課金が有効になるまでマージしないこと」とあります。予定日は 11 月 22 日です。
X は開発者フォーラムにも「[Inform] X API PPU - Expansions Update」という告知を出しています。自動取得には 403 を返すため、開いていません。数字はすべてプルリクエストから取りました。
プルリクエストにある単価は次のとおりです。
- ポスト $0.005、ユーザー $0.010:変更なしです。
- メディア・投票・場所・トピック:1 件 $0.005 です。読み取り単価として新しく加わります。
- 写真 4 枚のポスト:メディア 4 件として 4 回課金されます。
X API の従量課金で、expansions はいくらになる?
課金は件数の合計です。
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 |
3 行目の計算は 100 × $0.005 + 60 × $0.010 + 40 × $0.005 で、$1.30 です。X のプルリクエストにある計算例と同じ数字です。2 行目は $0.50 に $0.60 が加わります。
最後の行は Owned Reads の例です。自分のアプリで、自分のポスト、メンション、いいねを読むことを X はこう呼びます。この場合の expansion は 1 件 $0.001 なので、131 件で $0.131 です。OAuth で他人のデータを読むのは Owned Reads ではありません。
X の公式ドキュメントはいまどうなっている?
2026 年 11 月 16 日時点で、料金ページ(13 日更新)の読み取り表には Posts: Read が $0.005、User: Read が $0.010 とあります。Media、Poll、Place の読み取り行と expansions の節は、まだありません。
expansions のページにも課金の記載はありません。「1 回のレスポンスに関連オブジェクトを含める」機能だと説明されているだけです。
つまり新しいルールは、プルリクエストがマージされるまで公開ドキュメントに載りません。プルリクエストとフォーラムの告知を予定として扱い、22 日に Developer Console で実際の請求を確かめてください。全体の単価表は X API 料金 2026 のまとめにあります。
expansions 課金を減らす方法
増える分の大半はユーザーです。
author_id を付けると、ポストごとに最大 $0.010 のユーザーが加わります。まずそこを削ります。
- 読まない expansions は外す:X もプルリクエストで、使うものだけを要求するよう勧めています。
- 著者がわかっているなら
author_idを外す:from:検索なら、著者はすべて同じアカウントです。 - プロフィールは 1 日保存する:保存済みのユーザーは無料です。X の重複除外も、同じ UTC 日の中で同じ働きをします。
- Developer Console を見る:1 日の支出を、上の計算と見比べます。
レスポンスの金額は、オブジェクトを数えればわかります。次のスクリプトは 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"))))
重複除外は計算に入れていないので、上限の目安です。X の無料クレジットも関係します。最初の $20 と同額の上乗せは X API 無料クレジットの記事で説明しています。
expansions に課金されない安い読み方は?
Weir がその 1 つです。Weir の検索結果では、各ポストに著者の情報が付いてきて、著者の分は別に課金されません。ポスト 1 件が 1 クレジット、呼び出し 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 ポストです。20 件ずつ 5 ページで、105 クレジットです。$5 パック(25,000 クレジット)なら $0.021、$20 パック(120,000 クレジット)なら $0.0175 です。
著者つきの同じ 100 ポストは、X の計算例の $1.30 と比べて Weir で約 60 分の 1 です。ほかの選択肢との比較は X API 料金インデックスに、自分の件数での計算は X API 料金計算ツールにあります。
Weir は毎月最初の 5,000 クレジットが無料で、カード登録は要りません。詳しくは Weir の料金ページをご覧ください。
Weir が向かないケース
- 投稿・返信・いいねをしたい:Weir は読み取り専用です。書き込みは X の API だけです。
- 自分のアカウントの非公開データが必要:ブックマーク、DM、分析には自分の X ログインが要ります。Weir は公開データだけを読みます。
- 契約や社内ルールで X が指定されている:Weir は X のライセンスを受けておらず、アクセスが変わる可能性があります。該当する規約は各自で確認してください。法的助言ではありません。
- 全量データ(firehose)が必要:1 日数百万ポストは別の枠で、X か Enterprise 向けデータ事業者への見積もりが向いています。
よくある質問
X API の料金は 2026 年 11 月 22 日に値上げされますか?
expansions を使う呼び出しだけが対象です。11 月 22 日から includes の各オブジェクトが課金され、ユーザーは $0.010、ポスト・メディア・投票・場所は $0.005 です。expansions なしの呼び出しの料金は変わりません。
X API の expansions=author_id は追加料金がかかりますか?
はい、2026 年 11 月 22 日からです。includes.users に返る著者 1 人ごとに、ユーザー読み取りの $0.010 がかかります。ポストの author_id フィールドだけなら、ポストに付く ID にすぎません。
写真 4 枚のポストでメディアは何件課金されますか?
4 件です。X のプルリクエストでは、メディアオブジェクトは 1 件ずつ $0.005 なので、写真 4 枚で $0.020 です。同じ UTC 日に同じメディアキーが返っても、2 回は課金されません。
X API の expansions 課金を避けるには?
使う expansions だけを要求します。著者のプロフィールは 1 日 1 回だけ取得して保存し、Developer Console を見ます。ポストごとに著者が付く Weir なら、著者の分は別料金になりません。
参考資料
2026 年 11 月 16 日に確認しました。
- X docs リポジトリ、プルリクエスト 520「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 pricing、最終更新 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 クレジット