X API キーの取得方法 2026：Bearer Token と使い方

X API キーを取得するには、console.x.com にログインしてアプリを作り、一度だけ表示されるキーを保存します。

2026 年に初めて X（旧 Twitter）の API を使う人向けです。X 公式の手順、認証情報ごとの役割、最初の呼び出しとその料金をまとめました。最後に、私たちが運営する Weir の無料キーも紹介します。

Bearer Token を手に入れたら、X のクイックスタートにある最初の呼び出しを試せます。

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

1. console.x.com にログインX アカウントで入り、開発者契約に同意します。
2. アプリを作成名前、説明、用途を入力します。
3. 認証情報を保存表示は一度だけ。パスワード管理ツールへ。
4. クレジットを購入従量課金なので、残高がないと呼べません。
5. 最初の呼び出しBearer Token でユーザー情報を取得します。

ステップ 1：X Developer Console でアプリを作成する

X の「Getting access」ページは、X Developer Console（console.x.com）へ案内しています。アプリの持ち主にしたい X アカウントでログインします。

そのあとの手順は 3 つです。

1. 開発者契約とポリシーに同意します。 API を使うための X との契約です。
2. 使い方を説明します。 API をどう使うかの基本情報を求められます。
3. ［New App］をクリックします。 名前、説明、用途を入れます。

これで、コンソールがキーとトークンを作ります。

日本語の古い解説には、developer.twitter.com で英語の利用目的を書いて審査を待つ手順が残っています。10 月 26 日に確認した X のページには、審査待ちの記述はありませんでした。

ステップ 2：API キー、シークレット、Bearer Token を保存する

認証情報は一度しか表示されません。X のページは、なくしたら再生成するしかなく、再生成すると古いものは無効になると書いています。

X が作る認証情報と、それぞれが要る場面です。

最初のプロジェクトなら、たいてい Bearer Token だけで足ります。

古い記事では、API キーとシークレットを「Consumer Keys」と呼んでいます。

ステップ 3：クレジットを購入する（無料プランはありません）

X の API は従量課金です。料金ページは「Developer Console でクレジットを先に購入」するよう書き、請求の FAQ はクレジットがないとリクエストが失敗するとしています。

2026 年 10 月 26 日時点で、料金ページにも Getting access ページにも無料プランはありません。

無料クレジットには条件があります。X の無料クレジットのページによると、最初にカードでクレジットを買うと $20 がもらえます。

最初の自動チャージにも、$50 までの同額が付きます。カードを登録するだけでは、10 月 13 日から対象外です。どちらも付与から 3 か月で失効します。

X はこの特典を「順次展開中」としているので、まだ付かないアカウントもあります。

ループを書く前に、コンソールで利用上限を設定してください。全料金は X API の料金 にまとめています。

ステップ 4：Bearer Token の使い方：最初の API 呼び出し

コンソールでアプリを開き、Bearer Token をコピーします。環境変数に入れて、X 公式の例であるユーザー検索を実行します。

export BEARER_TOKEN="ここにトークンを貼る"
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

X のクイックスタートには、次の応答が載っています。

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

ユーザー 1 件なので、「User: Read」の料金で $0.010 です。

検索はもっとかかります。最近の検索は初期設定で 10 件を返すので、1 ページ目で $0.05 です。

同じ日にもう一度呼んでも、二重には課金されないはずです。X は UTC の 1 日の中で重複を除き、これを「soft guarantee」と呼んでいます。

読むだけなら無料で使える API キー

公開データを読むだけなら、X のアプリ作成も前払いのクレジットも要りません。ここで紹介する Weir は、私たちが運営する読み取り専用の API です。その点を踏まえて読んでください。

カードなしで 登録（英語）し、ダッシュボードの API keys でキーを作ります。X と同じくキーの表示は一度だけで、保存されるのはハッシュだけです。

同じユーザー検索を Weir で実行します。

curl https://api.weirapp.io/v1/x/users/XDevelopers \
  -H "Authorization: Bearer $WEIR_API_KEY"

2026 年 10 月 26 日に実行すると、3 クレジットでした。呼び出しに 1、プロフィールに 2 です。応答の抜粋です。

{
  "data": {
    "id": "2244994945",
    "username": "XDevelopers",
    "name": "Developers",
    "followersCount": 697724,
    "createdAt": "2013-12-14T04:35:55.000Z"
  }
}

ID は同じで、表示名とフォロワー数は X のサンプルではなく実際の値です。

毎月の無料 5,000 クレジットで、この検索なら約 1,600 回です。検索に使えば約 4,760 ポスト読めます。失敗した呼び出しは無料です。

X API$5.00

TwitterAPI.io$0.15

Weir、$5 パック約 $0.21

TwitterAPI.io の料金ページは 1,000 ツイート $0.15 で、1 ポストあたりは Weir より安いです。Weir の数字は、1 ページ約 20 件の検索で、1 ポスト 1 クレジットと 1 回 1 クレジットの計算です。自分の用途は X API コスト計算ツール（英語）で試算できます。

X API キーが使えないときは

初日によく出るエラーです。

• 401 Unauthorized：トークンが違う、ない、または再生成済みです。Authorization: Bearer ヘッダーを確かめます。
• 402 Payment Required：残高が空です。クレジットを買うまで通らないので、402 エラーの解説（英語）を見てください。
• 403 Forbidden：認証は通っても権限がありません。ユーザー認証が要る機能に Bearer Token を使った場合などです。
• 429 Too Many Requests：レート制限です。x-rate-limit-reset の時刻まで待ちます。
• シークレットをなくした：X は再表示できません。再生成してコードを更新します。

Weir が向かないケース

• 投稿、返信、いいね、DM：Weir は読み取り専用で、書き込めるのは X の API だけです。
• X 自身の規約と保証：Weir は X の公認ではないので、使える範囲が変わることがあります。
• 自分のアカウントを読む：X はこの「Owned Reads」を 1 件 $0.001 にしています。
• 1 ポストの単価だけが大事：TwitterAPI.io のほうが安いです。

よくある質問

X API キーは無料で取得できますか？

アプリやキーの作成に料金はありませんが、データを返す呼び出しはすべてクレジットを使います。2026 年 10 月時点で、料金ページに無料プランはありません。新しいアカウントは最大 $70 の無料クレジットを得られますが、どちらも先に支払いが要ります。

X Premium に入らないと API キーは取れませんか？

いいえ。Getting access ページが求めるのは、X アカウント、開発者契約への同意、用途の説明だけです。X の Premium のページにも、API が使えるプランはありません。詳しくは X Premium と API（英語）にまとめました。

Bearer Token はどこで確認できますか？

console.x.com の X Developer Console です。アプリを開き、認証情報から Bearer Token をコピーします。表示は一度だけなので、なくしたら再生成します。API キーとシークレットから作る方法も、X のドキュメントにあります。

1 つの API キーで読み取りも投稿もできますか？

Bearer Token は公開データを読むだけです。自分のアカウントで投稿するなら、アクセストークンとシークレットを使います。ほかの人の代わりに操作するなら、クライアント ID で OAuth 2.0 を使います。投稿は 1 件 $0.015 です。

参考資料

英語の資料は、いずれも 2026 年 10 月 26 日に確認しました。

• X API, Getting access（英語）：https://docs.x.com/x-api/getting-started/getting-access
• X API, Make your first request（英語）：https://docs.x.com/make-your-first-request
• X API pricing（英語）：https://docs.x.com/x-api/getting-started/pricing
• X API free credits（英語、10 月 13 日の変更を含む）：https://docs.x.com/x-api/getting-started/free-credits
• X API usage and billing FAQ（英語、10 月 22 日に確認）：https://docs.x.com/x-api/fundamentals/post-cap
• X developer apps and credentials（英語、10 月 22 日に確認）：https://docs.x.com/fundamentals/developer-apps
• X app-only bearer tokens（英語）：https://docs.x.com/fundamentals/authentication/oauth-2-0/bearer-tokens
• X API recent search reference（英語、max_results は 10〜100）：https://docs.x.com/x-api/posts/search-recent-posts
• X API response codes and errors（英語）：https://docs.x.com/x-api/fundamentals/response-codes-and-errors
• X Help Center, About X Premium（英語、Wayback の 10 月 10 日版、10 月 22 日に確認）：https://help.x.com/en/using-x/x-premium
• TwitterAPI.io pricing（英語）：https://twitterapi.io/pricing
• Weir authentication、billing（英語）：https://docs.weirapp.io/authentication 、https://docs.weirapp.io/billing
• Weir での @XDevelopers の取得（10 月 26 日、3 クレジット）