お悩み女子Xで自動投稿をしたくてAPIを取ろうとしたけれど、手順が変わっているようで、何から始めればいいのか分からない……
X APIの取得は、開発者コンソールにX（旧Twitter）のアカウントでサインインし、アプリを作ってキーとトークンを受け取ります。
この記事では2026年10月時点のX APIの取得手順と、受け取ったキーの保管、最初のリクエストで接続を確かめる方法を紹介します。手順と料金は公式ドキュメント（docs.x.com）で確かめました。APIキーが手元になく、X APIには問い合わせていないので、画面操作とリクエストの結果は公式の説明どおりに書いています。X APIは料金や仕組みが変わりやすいため、申し込む前に公式ページで最新の内容を確かめてください。
- X APIの料金の仕組みと、費用の見方
- 開発者コンソールでアプリを作る3ステップ
- 4種類の認証情報の使い分けと、保管の決まり
- 最初のリクエストで接続を確かめる方法
- 401・403・429が出たときの見方と、使う前の規約
X APIの料金と費用の確認
現在のX APIは使った分だけ払う従量課金（pay-per-usage）です。取得の前に、費用の仕組みを押さえておきます（2026年10月時点の公式ドキュメントによる）。
公式が説明する料金の仕組み
- クレジットの前払い：開発者コンソールでクレジットを買い、リクエストのたびに引かれます。
- サブスクリプションなし：契約や最低利用額はなく、使った分だけです。
- エンドポイントごとの単価：読み取りは取得した件数、書き込みはリクエストの回数で課金されます。
- 支出の上限：請求サイクルごとの上限を設定でき、達するとリクエストは止まります。
公式は開発やテストの間こそ支出の上限を設定するよう勧めています。思わぬ請求を防げるためです。無料で使える範囲の有無と条件は、この記事では確かめられていません。開発者コンソールの表示で確かめてください。
主な単価の例
公式の料金ページに載っていた単価のうち、自動投稿や読み取りで関わるものを選びました。
| 操作 | 単価 | 課金の単位 |
|---|---|---|
| Postの読み取り | 0.005ドル | 取得した1件ごと |
| ユーザー情報の読み取り | 0.010ドル | 取得した1件ごと |
| 自分のデータの読み取り | 0.001ドル | 取得した1件ごと |
| Postの作成 | 0.015ドル | 1リクエストごと |
| URL付きPostの作成 | 0.200ドル | 1リクエストごと |
URL付きの投稿は、URLなしの投稿より単価が高く設定されています。ブログのリンクを毎日投稿する場合は、費用を先に見積もります。公式は「価格は変更されることがある」と書いているので、現在の単価は開発者コンソールで確かめます。
X APIの取得手順｜開発者コンソールでアプリを作る
公式の「Getting Access」に沿って、登録、アプリの作成、認証情報の保存の順に進めます。
① 開発者アカウントを作る
- 開発者コンソール（console.x.com）を開き、Xのアカウントでサインインする
- Developer Agreement and Policy（開発者契約とポリシー）を読んで同意する
- プロフィールの入力画面で、APIの使い道を書く
② アプリを作る
開発者コンソールのダッシュボードから新しいアプリを作り、名前・説明・用途を入力します。作成後に、キーとトークンを生成します。公式は開発用・テスト用・本番用でアプリを分けることを勧めています。
③ 認証情報を保存する
認証情報を生成したら、すぐに保存します。
認証情報は画面に一度しか表示されません。パスワード管理ツールなどの安全な場所へ、その場で保存します。なくした場合は再生成になり、古いものは使えなくなります。
X APIの認証情報｜4種類のキーとトークンの使い分け
アプリを作ると、役割の違う4組の認証情報が出ます。どれを使うかはやりたいことで決まります。
| 認証情報 | 役割 | 向いている用途 |
|---|---|---|
| API Key & Secret | アプリの識別。OAuth 1.0aの署名やトークンの生成に使う | 署名つきのリクエスト |
| Bearer Token | アプリ単独での認証 | 公開データの読み取り（検索、ユーザー情報の取得） |
| Access Token & Secret | 自分のアカウントとしての操作（OAuth 1.0a） | テスト、個人のbot、自分の自動化 |
| Client ID & Secret | OAuth 2.0のユーザー認証 | ほかのユーザーに代わった投稿やいいね |
公式は新しいプロジェクトにはOAuth 2.0を勧めています。使う権限（スコープ）を細かく絞れるためです。自分のアカウントだけで動かすなら、Access Token & Secretを使う方法もあります。
OAuth 1.0aのアプリには、Read only、Read and write、Read, write, and DMsの3段階の権限があります。投稿するには、Read and write以上が必要です。
保管の決まりは公式の「ベストプラクティス」と同じです。キーはコードに書かず環境変数に入れ、設定ファイルは .gitignore で除き、定期的に再生成します。環境変数の入れ方はAPIキーの安全な管理方法で扱っています。
X APIの初期設定と接続確認
最初は読み取りだけのリクエストで接続を確かめます。書き込みを伴う投稿は、接続が確かめられてから試します。
Bearer Tokenを環境変数に入れる
Windowsの環境変数の設定画面で、変数名を X_BEARER_TOKEN、変数値をBearer Tokenにして登録します。登録したあとは、コマンドプロンプトを開き直します。
最初のリクエストを送る
公式の「Make Your First Request」にあるユーザー情報の取得を、Pythonで書いたものです。Authorization ヘッダーに Bearer とトークンを入れます。requestsの使い方はrequests入門にあります。
import os
import requests
bearer_token = os.environ["X_BEARER_TOKEN"]
url = "https://api.x.com/2/users/by/username/xdevelopers"
res = requests.get(url, headers={"Authorization": f"Bearer {bearer_token}"}, timeout=15)
print(res.status_code)
print(res.json())このコードはrequests.get を偽物に差し替えて、環境変数が読めることと、URLとヘッダーが公式の例と同じ形になることだけを確かめました（Windows 11、Python 3.12）。X APIには送っていません。実際に送ると、ユーザー情報1件の読み取りとして、公式の単価表では0.010ドルがかかります。
返ってくるJSONの形
公式のドキュメントには、次の例が載っています。取得した情報は data の中にあります。
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers"
}
}これは公式の例で、筆者が受け取った結果ではありません。JSONの読み方はPythonでJSONを扱う基本で扱っています。
X APIでつまずきやすい点｜401・403・429と使う前の規約
エラーはステータスコードで原因の見当を付けます。続けて、使う前に確認する規約を整理します。
401・403・429の見方
| コード | 意味 | 確認すること |
|---|---|---|
| 401 | 認証情報が正しくない、または見つからない | トークンが再生成されていないか。ヘッダーが「Bearer トークン」の形か |
| 403 | 認証はできたが、その操作の権限がない | アプリの権限設定。ユーザー認証が必要なエンドポイントではないか |
| 429 | レート制限または使用上限を超えた | レスポンスヘッダーの x-rate-limit-reset の時刻まで待つ。待ち時間を延ばしながら再試行する |
使う前に確認する規約
公式の開発者ガイドラインとポリシーから、取得の段階で押さえておく点を選びました。
- 公式APIだけを使う：スクレイピングやブラウザの自動操作は、永久停止の対象と書かれています。
- スパムやプラットフォーム操作の禁止：同じ内容を複数アカウントで投稿することも含まれます。
- 書き込みは自動化のルールに従う：投稿、フォロー、DMを自動で行うサービスが対象です。
- botであることを明記する：プロフィールに、botであることと運営者を書きます。
投稿を自動化したい場合の具体的な線引きは、X APIとGASのbot連携で扱っています。
X APIの取得に関するよくある質問
料金、キーの再生成、自動投稿用アカウントについての疑問をまとめました。
- X APIは無料で使えますか？
-
公式の料金ページはクレジットを前払いする従量課金を説明しています。一方で、開発者ガイドラインには「無料プランは非商用のみ」という記述があります。無料で使える範囲の有無と条件は、開発者コンソールの表示で確かめてください。
- キーをなくしたり、公開してしまったりしたらどうしますか？
-
開発者コンソールのアプリのページで、該当するキーとトークンを再生成します。再生成すると古いものは使えなくなります。Gitに上げてしまった場合は、コードから消しても履歴にキーが残るため、再生成が必要です。
- 自動投稿用のアカウントは普段のアカウントと分けますか？
-
分ける場合は、プロフィールにbotであることと運営者を書き、人が管理するアカウントと紐づけます。公式のポリシーが求めている点です。条件はX APIとGASのbot連携にまとめています。
X APIの取得と初期設定の要点
X APIの取得と初期設定のポイントを整理します。
料金：従量課金でクレジットを前払い。支出の上限を設定し、単価は開発者コンソールで確かめる。
取得手順：開発者コンソールでサインインし、契約に同意し、アプリを作って認証情報を保存する。
認証情報：4種類を用途で使い分ける。一度しか表示されないので、すぐ保存し、環境変数で渡す。
動かした範囲：環境変数の読み込みとリクエストの組み立てのみ。X APIへの送信は未実行。
最初は読み取りのリクエストを1回だけ送り、ステータスコードが200で返るかを見てください。料金や仕組みは変わりやすいので、申し込む前に、公式ページで最新の内容を確かめます。
X APIを使った自動化は、次の記事でも扱っています。
参考資料
Getting Access | X Developer Platform
X API pay-per-usage pricing and credits | X Developer Platform
Make Your First Request | X Developer Platform
Developer Guidelines | X Developer Platform
X Developer Policy | X Developer Platform
Response Codes & Errors | X Developer Platform
