Twitter (X) API / X API の使い方:登録から最初のリクエストまで
Twitter (X) API / X API の使い方は、目的によって難易度が大きく変わります。公式 X API を使うなら、X Developer Console でアプリを作り、OAuth の複数キー（API Key / API Key Secret / Access Token / Access Token Secret、または Client ID / Secret）を取得し、pay-per-use 用のクレジットを用意してから認証付きリクエストを送ります。一方、第三者 API の TwitterAPI.io なら、Google でサインインして X-API-Key を1つコピーするだけで、約5分後には curl で最初のリクエストを実行できます。本記事は両方の使い方を、登録から最初のレスポンスまで最短ルートで解説します。
「Twitter API（X API）とは何で、どう使うのか」を調べる人の多くは、まず公式 Developer Console の手続きの多さでつまずきます。OAuth の鍵が4種類、申請フロー、従量課金の設定 —— ツイートを1件取得するまでの道のりが長いのです。
そこで本記事では、(1) 公式 X API の正攻法の使い方と、(2) OAuth 不要で最速の第三者 API の使い方を並べて示します。自分の用途（データ取得が中心か、公式機能が必須か）に合わせて選べるように、手順とcurl例、つまずきやすい点までまとめます。
Twitter (X) API とは？できること
Twitter (X) API（X API）は、ツイートの検索・取得、ユーザー情報、フォロワー、投稿などを、プログラムから扱うためのインターフェースです。Web 画面を操作する代わりに、HTTP リクエストでデータを読み書きします。
主な用途は、ブランド・話題のモニタリング、データ分析・研究、AI エージェントへのデータ供給、投稿の自動化など。読み取り（検索・タイムライン・ユーザー情報）が中心の用途が圧倒的に多く、本記事もそこを軸に説明します。
「使い方」を分ける最大の分岐点は認証です。公式 X API は OAuth が必須（後述）。第三者 API は API キー1つ。この違いが、最初のリクエストまでの時間を「数日〜2週間」と「約5分」に分けます。
公式 X API の使い方:Developer Console とOAuthキー取得
公式 X API を使う正攻法の手順です。
1. 開発者アカウント:developer.x.com の X Developer Console でアカウントを作成し、プロジェクトとアプリを登録します（用途の記述を求められます）。
2. キー取得:アプリの設定で、OAuth 1.0a 用の API Key / API Key Secret / Access Token / Access Token Secret、または OAuth 2.0 用の Client ID / Client Secret を発行します。用途により複数を組み合わせます。
3. 課金設定:新規開発者は pay-per-use（従量課金） が既定で、利用前にクレジットの用意が必要です（料金の詳細は下記の料金記事を参照）。
4. 認証付きリクエスト:取得したキーで OAuth 署名を付けて API を呼びます。署名の組み立てが最初の関門で、ライブラリ（例:各言語の OAuth クライアント）を使うのが一般的です。
つまり、最初の1リクエストまでに「アカウント審査 + 4種類の鍵 + OAuth 署名 + 課金設定」を越える必要があります。公式機能（Ads API、大規模な認証付き投稿、パートナー資格）が必須ならこの道ですが、データ取得が目的なら手順が重すぎることが多いです。
第三者 API の使い方:X-API-Key だけで約5分
データ取得が目的なら、OAuth 不要の第三者 API が最短です。TwitterAPI.io の場合の手順:
1. サインイン:twitterapi.io で Google サインイン。$1 の無料クレジット（約6,000回、カード不要）が自動付与されます。
2. API キーをコピー:ダッシュボードから X-API-Key を1つコピー。OAuth の4キーも署名も不要です。
3. 最初のリクエスト:X-API-Key ヘッダーを付けて /twitter/tweet/advanced_search か /twitter/user/last_tweets を叩くと、構造化された JSON が返ります。
開発者アカウントの審査も、OAuth 署名の実装も、課金の事前設定（無料クレジットで開始）も不要。だから「登録から最初のレスポンス」までが約5分で済みます。下のコードは、公式の OAuth 手順と第三者 API の curl を並べた比較です。
最初のリクエストを送る（curl 例）
実際に最初のレスポンスを得るところまで。第三者 API なら、キーをヘッダーに入れて GET するだけです（下のコード参照）。
返ってくる JSON には、ツイート本文・作成者・エンゲージメント数・投稿時刻などが含まれ、そのまま json.loads や jq で扱えます。検索は query(キーワード / from:user / #ハッシュタグ / lang:ja など)と queryType(Latest / Top)を指定します。
ページングは、レスポンスの next_cursor を次のリクエストの cursor に渡して繰り返します。これで複数ページを収集できます。
つまずきやすい点と使い方のコツ
公式で詰まりやすい点:OAuth 署名のミス（401）、申請の却下/保留、4キーの取り違え。OAuth クライアントライブラリを使い、キーは環境変数に置くのが鉄則です。
第三者 API のコツ:キーは X-API-Key ヘッダーに入れ、コードに直書きしない（環境変数へ）。バッチ処理は 30〜50 req/秒に抑えると安定します（固定のレート制限ウィンドウはありません）。
書き込みの境界:TwitterAPI.io は投稿・いいね・リツイート・フォローに対応しますが、DM 送信は提供していません(API 経由の DM は凍結リスクが高いため)。頻度は人間的に保ってください。
用途で選ぶ:データの読み取り・検索・監視が中心なら第三者 API が速くて安い。Ads API・大規模投稿・パートナー資格が必須なら公式 X API。
# Twitter (X) API の使い方:最初のリクエスト
# --- 第三者 API (TwitterAPI.io):X-API-Key だけ、OAuth 不要 ---
# 1. twitterapi.io で Google サインイン -> $1 無料クレジット（カード不要）
# 2. X-API-Key をコピーして:
curl -s -H "X-API-Key: YOUR_KEY" \
"https://api.twitterapi.io/twitter/tweet/advanced_search?query=AI%20lang:ja&queryType=Latest" \
| head -c 500
# 特定アカウントの最新ツイート:
curl -s -H "X-API-Key: YOUR_KEY" \
"https://api.twitterapi.io/twitter/user/last_tweets?userName=openai" | head -c 500
# --- 公式 X API:OAuth Bearer / 署名が必要（Developer Console でキー取得後）---
# curl -H "Authorization: Bearer $X_BEARER_TOKEN" \
# "https://api.twitter.com/2/users/by/username/openai"
# ※ 開発者アカウント審査 + 複数キー + pay-per-use クレジットが前提。
# 約5分（第三者）vs 数日〜2週間（公式の審査・OAuth 実装）。よくある質問
Twitter (X) API の使い方で最初に必要なものは？
公式 X API なら、X Developer Console（developer.x.com）での開発者アカウント、プロジェクト/アプリ、OAuth キー（API Key / Secret / Access Token / Secret、または Client ID / Secret）、そして pay-per-use 用のクレジットが必要です。第三者 API の TwitterAPI.io なら、Google サインインで発行される X-API-Key が1つあれば始められます（OAuth 不要）。
X API のキーはどこで取得しますか？
公式は developer.x.com の X Developer Console（2026年に新設された管理画面）でアプリを作成し、OAuth キーを発行します。第三者 API の TwitterAPI.io は、サインイン後のダッシュボードから X-API-Key を1つコピーするだけです。後者は審査もOAuth署名も不要なので、取得から最初のリクエストまでが圧倒的に速いです。
Twitter API は OAuth なしで使えますか？
公式 X API は OAuth が必須です（認証なしのアクセスはできません）。OAuth を使いたくない場合は、API キー方式の第三者 API を使います。TwitterAPI.io は X-API-Key ヘッダーだけで認証するため、OAuth の鍵交換や署名の実装が一切不要です。
最初のリクエストはどれくらいで送れますか？
第三者 API なら約5分です:Google サインイン → X-API-Key コピー → curl で /twitter/tweet/advanced_search を叩けば JSON が返ります。公式 X API は開発者アカウントの審査・複数キー取得・OAuth 署名の実装が前提で、最初のリクエストまで数日〜2週間かかることもあります。
Twitter API でツイートを検索するには？
TwitterAPI.io では /twitter/tweet/advanced_search に query(キーワード、from:user、#ハッシュタグ、lang:ja、期間指定など)と queryType(Latest または Top)を渡します。レスポンスの next_cursor を次の cursor に渡せば複数ページを取得できます。公式 X API でも検索は可能ですが、認証と料金（pay-per-use）の設定が前提です。
Twitter API の使い方で投稿（書き込み）はできますか？
TwitterAPI.io は投稿・いいね・リツイート・フォローに対応します（頻度は人間的に保ってください)。ただし DM 送信は提供していません — API 経由の DM は凍結リスクが高いためです。大規模な認証付き投稿や Ads API が必要なら、公式 X API が前提になります。