Twitter API の選び方：8つのチェック

#Twitter API の契約前に行う8つのチェック

Twitter API が自分の処理に合うかどうかは、8つのチェックで決まります。どれも1ドルも払わずに確認できます。

1. 処理を1,000件あたりの料金に換算する。 各見積もりを、自分の処理でのツイート、フォロワー、プロフィール1,000件あたりの費用に直します。各ツイートの投稿者分も含めます。

2. ID によるバッチ取得があるか調べる。 1回の呼び出しで100ツイートまたは100プロフィールが返り、1回分として課金されることが条件です。

3. 最初のプランのレート制限を確認する。 最上位プランではなく、最初に契約するプランの毎秒リクエスト数を確認します。

4. 自分のデータで無料テストする。 無料枠が全エンドポイントで使え、カード不要・有効期限なしであることが条件です。

5. API が X アカウントに何を求めるか確認する。 X のログイン情報、Cookie、セッショントークンを求めてはいけません。

6. 実績と稼働率を文書で確認する。 本番での稼働年数と、規約に明記された稼働率を探します。

7. 処理の各ステップにエンドポイントが対応するか確認する。 取得から検索履歴、キャンペーンの確認まで、各ステップに専用のエンドポイントが必要です。

8. 請求が予測できるか確認する。 固定のプラン、失敗した呼び出しは課金されないこと、自分で設定できる利用上限が条件です。

ここでいう Twitter API とは、HTTPS で X のデータを返すサービス全般です。X Corp が提供する公式 X API と、X の開発者アカウントではなくプロバイダー独自の API キーで呼び出すサードパーティの Twitter API の両方が含まれます。チェックはどちらにも同じように使えます。

公式 X API は、すべての見積もりを測る基準になります。従量課金プラン（新しいタブで開きます）では、前払いで購入したクレジットから1,000投稿あたり$5.00、1,000ユーザーまたはフォロワーあたり$10.00が課金され、請求サイクルあたり300万件の投稿読み取りで止まります。料金表の各項目は X API の料金で詳しく解説しています。

チェック1と2はほとんどの予算を左右し、チェック5は X アカウントにリスクがあるかどうかを決めます。投稿はこのリストの対象外です。自分のアカウントとして投稿できるのは、公式 X API だけです。

#Sorsa API の8項目の採点

2022年から本番稼働し、累計60億リクエスト以上を処理してきた Twitter（X）API 兼スクレイピングツールである Sorsa API は、8つのチェックをすべて数字で満たします。どんな規模でも公開 X データを読み取るなら、選ぶべき API です。次の表では、各項目の合格ラインを Sorsa API と公式 X API の横に並べています。

• 1. 1,000件あたりの料金

  合格ライン

  支払う前にわかり、投稿者分を含む

  Sorsa API

  ツイート1,000件あたり$0.014から、投稿者はすべてのツイートに含まれる

  公式 X API

  1,000投稿あたり$5.00、2026年11月22日から投稿者1件ごとに$0.010加算

• 2. バッチ取得

  合格ライン

  1回の呼び出しで100件、1回分として課金

  Sorsa API

  1リクエストでツイートまたはプロフィール100件、フォロワーは1ページ200件

  公式 X API

  1回の呼び出しで最大100投稿、投稿ごとに課金

• 3. レート制限

  合格ライン

  毎秒単位で、エントリープランでも同じ

  Sorsa API

  無料アカウントを含む全プランで毎秒20リクエスト

  公式 X API

  エンドポイントごと、多くは15分単位

• 4. 無料テスト

  合格ライン

  全エンドポイント、カード不要、期限なし

  Sorsa API

  有効期限のない100リクエスト

  公式 X API

  無料プランなし

• 5. X アカウント

  合格ライン

  ログイン情報や Cookie を求めない

  Sorsa API

  読み取り専用、X のログイン情報は一切求めない

  公式 X API

  開発者アカウント、アプリ、OAuth

• 6. 実績

  合格ライン

  数年の本番稼働、規約に明記された稼働率

  Sorsa API

  2022年から、規約に稼働率99.9%

  公式 X API

  X Corp 自身の API。アクセスルールは2023年と2026年に変更

• 7. エンドポイント

  合格ライン

  ステップごとに1つ、履歴は2006年まで

  Sorsa API

  45個のエンドポイント、2006年まで遡る検索、1回で済むフォロー確認

  公式 X API

  読み取りと書き込み。全期間検索は毎秒1リクエスト

• 8. 予測できる請求

  合格ライン

  固定プラン、失敗は無料、自分で設定する上限

  Sorsa API

  月額プラン、失敗したリクエストは課金なし

  公式 X API

  前払いクレジット。残高がゼロになると呼び出しが停止

ツイート、フォロワー、プロフィールを読み取るなら、Sorsa API を選んでください。1リクエストで100ツイートを1,000件あたり$0.014から取得でき、ツイートでは公式 X API の250分の1のコスト、全プランで毎秒20リクエストです。稼働率99.9%は、すべての有料プランで利用規約により保証されています。X に変更があっても Sorsa 側で修正するため、今日書いたコードはそのまま動き続けます。

以下では、各チェックについて、確認すべきこと、プロバイダーを不合格にする危険信号、Sorsa API の数字を示します。候補を並べて料金を比べたい場合は、Twitter API の代替サービスで、同じ1,000ツイートについて7つの API を比較しています。

#1. 処理を1,000件あたりの料金に換算する

見積もりが合格になるのは、自分の処理の1,000件あたりの費用に換算できるときです。各ツイートの投稿者分も含めて計算します。料金は呼び出し単位、結果単位、月額プランのどれかで示されますが、1回の呼び出しで何件返るかがわからないと、どれも比べられません。1ツイートを返す呼び出しと100ツイートを返す呼び出しは、同じ料金でも1ツイートあたりでは100倍の差になりえます。

公式 X API の課金は逆です。返した投稿1件ごとに$0.005を課金するため、1,000投稿は取得方法にかかわらず$5.00です。2026年11月22日からは、X の拡張オブジェクトに関するお知らせ（新しいタブで開きます）に基づき、投稿とともに返される投稿者プロフィールにも1件$0.010が課金されるため、投稿者付きの投稿は$0.015になります。

要注意： ページサイズが書かれていない1回あたりの料金、または各ツイートに上乗せして課金される投稿者分。

Sorsa API は、どのエンドポイントでも1回の呼び出しを1リクエストとして課金し、投稿者の完全なプロフィールをすべてのツイートに追加料金なしで含めます。100ツイートのバッチは1リクエストなので、ツイートは1,000件あたり$0.014から、フォロワーは$0.007から、プロフィールは$0.014からです。

手元の見積もりをコンバーターに入力すると、1,000件あたりに換算され、両方の API と並べて確認できます。

#2. ID によるバッチ取得があるか調べる

1回の呼び出しで、ID から100ツイートまたは100プロフィールを取得でき、それが1回分として課金される API が、このチェックに合格します。バッチ取得が最も重要になるのは再取得（rehydration）です。ツイート ID のリストから完全なツイートを取り戻す作業で、研究用データセットやエクスポートが共有される一般的な形はこの ID リストです。

実際の規模では、差は大きくなります。100万件のツイート ID の再取得は、バッチなら1万リクエストで、毎秒20リクエストなら約8分です。1件ずつの呼び出しなら100万回で、同じ速度でも約14時間かかります。

公式 X API も1回の呼び出しで最大100件の ID を受け付けますが、バッチ内のすべての投稿を課金し、レート制限のリファレンス（新しいタブで開きます）にあるとおり、アプリあたり15分に3,500回までの呼び出ししか認めません。同じ100万件の投稿に$5,000かかります。

要注意： 1件ずつの取得しかない、またはバッチエンドポイントがあっても中の項目ごとに課金される。

Sorsa API には、取得の用途ごとにバッチエンドポイントがあります。POST /tweet-info-bulk（新しいタブで開きます） はツイート ID またはリンクを最大100件、GET /info-batch（新しいタブで開きます） はユーザー名またはユーザー ID を最大100件受け付け、GET /followers（新しいタブで開きます） は1ページあたり最大200フォロワーを返します。どの呼び出しも1リクエストなので、100万ツイートは$14からです。

#3. 最初に契約するプランのレート制限を確認する

レート制限が合格になるのは、毎秒単位で数えられ、最初に契約するプランでも同じ値のときです。レート制限とは、API が一定の時間内に受け付けるリクエスト数のことで、それを超えると、ウィンドウがリセットされるまで呼び出しが 429 エラーで失敗します。

プロバイダーによっては、料金を払うまで無料枠やエントリープランを毎秒1リクエスト未満に抑えています。最上位プランを前提に組んだパイプラインは、本番の初日に止まってしまいます。エンドポイントごとに15分の別々のウィンドウで数えるところもあります。公式 X API がそうで、直近の検索はアプリあたり15分に450リクエスト、約2秒に1回です。ウィンドウごとの一覧は X API のレート制限にあります。

要注意： 上位プランでしか得られない制限、毎秒1リクエスト未満の無料枠、エンドポイントごとに別々のウィンドウ。

Sorsa API は、無料アカウントを含む全プランで、API キーあたり毎秒20リクエストを受け付け、ウィンドウは毎秒リセットされます。1リクエストで100ツイートなので、キー1つで毎秒最大2,000ツイートを読み取れます。大量利用のプランでは、依頼により制限を引き上げられます。

#4. 支払う前に自分の処理でテストする

無料枠が合格になるのは、全エンドポイントで実際の処理を実行でき、サインアップ時にカードが不要で、無料クレジットが消える期限もないときです。他人のデータでのデモ呼び出しでは、ほとんど何も証明できません。重要なのは、自分のアカウント、自分の検索、自分のフィールドが API から返ってくるかどうかです。

公式 X API に無料プランはありません。Twitter API は無料かで解説しているとおり、新規開発者は最初の読み取りの前に前払いクレジットを購入します。

要注意： 1週間や1か月で失効するクレジット、料金を払うまでロックされているエンドポイント、テストをサブスクリプションに変えてしまうサインアップ時のカード登録。

Sorsa API は、新規アカウントすべてに100回分の無料リクエストを付与します。全45個のエンドポイントで使え、カード不要で、有効期限もありません。自分の処理で10,000ツイートまたは20,000フォロワー分に相当し、後述のテスト手順は、そのうちのごく一部でチェックを実行します。

#5. API が X アカウントに何を求めるか確認する

API が合格になるのは、X のログイン情報、Cookie、セッショントークンを一切求めず、API が何をしても X アカウントに影響が及ばないときです。セッションを使って動く API は、利用者本人として動作するため、そのアカウントは X の自動化ルールの対象になります。書き込み権限も2つ目のリスクです。読み取りも投稿もできるキーでは、バグや AI エージェントが勝手に投稿、いいね、フォローをしてしまう可能性があります。

公式 X API は、自分の開発者アカウント、アプリ、OAuth 認証情報で動作します。アカウントが自分のものでなければならない投稿には、これが適しています。

要注意： 公開データを読むだけなのに「X アカウントを連携してください」「認証トークンを貼り付けてください」と求められる、または読み取りと同じキーで書き込み操作ができる。

Sorsa API は設計上読み取り専用です。投稿、いいね、フォロー、DM の送信は一切行わず、X のログイン情報や Cookie も求めないため、X アカウントへのリスクはゼロです。返すのは公開データのみで、非公開アカウントと DM は、どのキーでも取得できません。

#6. 実績と稼働率を文書で確認する

プロバイダーが合格になるのは、何年も運用してきた実績があり、トップページだけでなく規約に稼働率を明記しているときです。API が本番で稼働してきた期間（現在の名前でも以前の名前でも）、ある月に基準を下回ったときに規約が何を約束しているか、レスポンスのフィールド名と型が維持されてパーサーが動き続けるかを確認してください。

要注意： 規約に稼働率の保証がない、レスポンスのフィールドの形が変わる、自分で保守し続けなければならないライブラリ。

Sorsa API は2022年から本番稼働して累計60億リクエスト以上を処理しており、当初は TweetScout API という名前でした。稼働率99.9%は、すべての有料プランの規約に含まれています。ある月の稼働率が99.5%を下回った場合、Sorsa API は月間リクエスト数の10%に相当するボーナスリクエストを付与します。X に変更があっても Sorsa 側で修正するため、連携は動き続けます。

#7. 処理の各ステップにエンドポイントが対応するか確認する

API が合格になるのは、処理の各ステップに専用のエンドポイントがあり、検索が自分の問いに必要な過去まで遡れるときです。エンドポイントの数は、必要なステップがなければ意味がありません。フォロワー一覧からフォロー確認を作り直すと数千回の呼び出しが必要ですが、確認用のエンドポイントなら1回です。処理をステップに書き出してみてください。Sorsa API での典型的な読み取り処理は、次のように対応します。

• ID またはリンクでツイートを取得

  Sorsa API のエンドポイント

  POST /tweet-info-bulk

  1リクエストあたり

  100ツイート

• プロフィールを一括取得

  Sorsa API のエンドポイント

  GET /info-batch

  1リクエストあたり

  100プロフィール

• フォロワーを出力

  Sorsa API のエンドポイント

  GET /followers

  1リクエストあたり

  200フォロワー

• 2006年まで遡ってツイートを検索

  Sorsa API のエンドポイント

  POST /search-tweets（新しいタブで開きます）

  1リクエストあたり

  約20ツイート

• あるアカウントが別のアカウントをフォローしているか確認

  Sorsa API のエンドポイント

  POST /check-follow（新しいタブで開きます）

  1リクエストあたり

  1回の確認

要注意： 数日前までしか遡れない検索、キャンペーン用の確認エンドポイントがない、投稿者なしで返ってくるツイート。

Sorsa API には45個のエンドポイントがあり、フィールドとともに Sorsa API のエンドポイントに一覧があります。検索は X の演算子に対応し、2006年まで遡れます。フォロー、リツイート、引用、コメントの確認は、それぞれ1回の呼び出しで、1回の確認あたり$0.0014からです。X リスト、スペース、X 記事（Articles）、「このアカウントについて」のデータにも、それぞれ専用のエンドポイントがあります。

#8. 請求が予測できるか確認する

請求が合格になるのは、月が始まる前に翌月の金額がわかり、失敗した呼び出しに費用がかからず、プランを使い切ったときの挙動を自分で決められるときです。自分で設定する上限がなければ、暴走したループがそのまま請求書になります。

公式 X API は、返されたリソースごとに前払いクレジットから差し引きます。料金ページによれば、残高がゼロになると、クレジットを追加するまで API リクエストはブロックされ、利用上限を設けた場合は次の請求サイクルまでブロックされます。

要注意： 失敗した呼び出しや空の呼び出しへの課金、利用上限がない、上限なしで設定された超過料金。

知っておきたいこと

請求を比べる前に、リトライの回数を数えてください。タイムアウトや 429 エラーをリトライするパイプラインは、失敗した呼び出しを課金する API では、リトライのたびに料金を払うことになります。Sorsa API では失敗したリクエストは課金されないため、リトライが課金されるのは成功したときだけです。

Sorsa API は、月間10,000から1,000万リクエストまでの月額プランを、それぞれ固定価格で提供しています。GET /key-usage-info（新しいタブで開きます） はキーの残りリクエスト数を返し、この呼び出し自体は消費されません。プランを使い切ると呼び出しは止まりますが、従量課金を有効にすれば、前払い残高から追加リクエストの料金が支払われます（Pro プランでは1,000件あたり$1.99で、プラン自体の単価と同じです）。利用上限は、請求期間あたりの既定値が$100で、引き上げられます。

#100回分の無料リクエストで8つのチェックを実行する

Sorsa API では、チェック1、2、4、7、8を、無料リクエストのうちの数回で約10分で実行できます。使用量の確認自体は無料だからです。デモではなく自分の処理を見るために、自分の ID、ハンドル、検索語を使ってください。

1. キーを取得する。 サインアップして、ダッシュボードから API キーをコピーします。カードは不要で、100回分の無料リクエストに有効期限はありません。

2. 残高を確認する。 GET /key-usage-info はキーのリクエスト数を返し、費用はかからないので、テストの前後に呼び出せます。

   curl "https://api.sorsa.io/v3/key-usage-info" \
     -H "ApiKey: YOUR_API_KEY"
   

   {
     "key_requests": 100,
     "remaining_requests": 100,
     "total_requests": 0
   }
   

3. 1リクエストで100ツイートを取得する。 最大100件のツイート ID またはリンクを POST /tweet-info-bulk に送ります。返ってきたツイートの数を数え、それぞれの user に投稿者が含まれていることを確認してください。これで、自分のデータについてチェック1と2が確認できます。

   curl -X POST "https://api.sorsa.io/v3/tweet-info-bulk" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"tweet_links": ["1853120044917735424",
                         "1853098761204531200"]}'
   

   {
     "tweets": [
       {
         "id": "1853120044917735424",
         "full_text": "Shipped the weekly export: 48K rows, zero gaps.",
         "created_at": "2026-11-01T09:12:40Z",
         "lang": "en",
         "likes_count": 214,
         "retweet_count": 31,
         "reply_count": 12,
         "view_count": 18240,
         "user": {
           "id": "1712900461123481600",
           "username": "lena_signalwatch",
           "display_name": "Lena Signal",
           "followers_count": 3870,
           "verified": false
         }
       }
     ]
   }
   

   レスポンス全体を表示

4. フォロワー一覧をページネーションで取得する。 GET /followers は1ページあたり最大200フォロワーを返します。next_cursor が返らなくなるまで、返ってきた値を次のリクエストに渡します。403 はキーがない、またはリクエスト残量がないことを、429 は1秒に20リクエストを超えたことを示します。

   import requests
   
   URL = "https://api.sorsa.io/v3/followers"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   
   params = {"username": "orbit_dataworks_hq"}
   followers = []
   for page_no in range(3):  # three pages are enough for the test
       resp = requests.get(URL, headers=HEADERS, params=params, timeout=30)
       resp.raise_for_status()
       page = resp.json()
       followers.extend(page["users"])
       cursor = page.get("next_cursor")
       if not cursor:
           break
       params["next_cursor"] = cursor
   
   print(len(followers), "followers in", page_no + 1, "requests")
   

   const URL = "https://api.sorsa.io/v3/followers";
   const HEADERS = { ApiKey: "YOUR_API_KEY" };
   
   const params = new URLSearchParams({ username: "orbit_dataworks_hq" });
   const followers = [];
   let pages = 0;
   while (pages < 3) {  // three pages are enough for the test
     const resp = await fetch(`${URL}?${params}`, { headers: HEADERS });
     if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
     const page = await resp.json();
     pages += 1;
     followers.push(...page.users);
     if (!page.next_cursor) break;
     params.set("next_cursor", page.next_cursor);
   }
   
   console.log(followers.length, "followers in", pages, "requests");
   

5. 過去の日付で検索する。 X の until: 演算子を付けたクエリを POST /search-tweets に送り、必要な期間の履歴が返ってくるかを確認します。これがチェック7です。

   curl -X POST "https://api.sorsa.io/v3/search-tweets" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "data pipeline until:2012-01-01", "order": "latest"}'
   

6. もう一度残高を確認する。 GET /key-usage-info をもう一度呼び出します。remaining_requests は、成功した呼び出しの回数だけ減っているはずです。どのエンドポイントでも1回の呼び出しにつき1リクエストで、これがチェック8の確認になります。

このテストで使うのは約5リクエストです。100回分の残りは、試したい処理のためにキーに残ります。

#8つすべてに合格する API を選ぶ

正しい Twitter API とは、自分の処理で8つのチェックすべてに合格する API です。最初に確認するのは、1,000件あたりの料金です。公開 X データの読み取りなら、それは Sorsa API です。100件のバッチでツイートは1,000件あたり$0.014から、フォロワーは$0.007から、全プランで毎秒20リクエスト、規約に稼働率99.9%、失敗したリクエストは課金されず、X のログイン情報も求めません。候補をチェックにかけ、実際の処理に無料リクエストを少し使い、いま支払っている金額と請求額を比べてみてください。公式 X API は、自分のアカウントが公開する投稿用に残しておきましょう。同じ数字で順位を付けたものは、最適な Twitter APIにあります。

#よくある質問