更新：2026年7月8日。1,000データユニットあたりのレートと100回分の無料リクエストの開始オファーを追加し、2026年4月20日の変更後の X の従量課金の料金に対して刷新し、取得可能なデータに対する2024年6月のいいねのプライバシー制限を確認しました。
要点： Twitter/X API は、公開のプロフィールデータ、いいね、リツイート、返信、表示回数のようなエンゲージメント指標付きの完全なツイートの内容、キーワードとメンションの検索、フォロワーとフォロー中のリスト、音声スペースの詳細、そしてリストとコミュニティのメンバーシップを公開します。また、アカウントがフォロー、リツイート、または返信したかどうかを検証します。投稿には別の書き込みアクセスが必要です。
何を取得でき、各呼び出しがいくらかかるかは、どの API を使うかに依存します。公式 X API はリソース単位で課金するため、応答の中のすべてのプロフィール、ツイート、またはフォロワーが別々の課金で、2026年2月以降は無料枠がありません。Sorsa API は、異なる働き方をする公開データのための代替の Twitter/X API です。課金はリクエスト単位でフラットなので、40個の読み取り専用のエンドポイントにわたって、いくつの項目を返しても1呼び出しは1リクエストとして数えられます。1回の /followers 呼び出しは1リクエストで最大200のプロフィールを返し、/tweet-info-bulk は同じく1リクエストで作者データ込みの最大100の完全なツイートを返します。認証はヘッダーの1つの API キーで、OAuth のフローもアプリのレビューもありません。バッチエンドポイントでは、データは1,000ツイートあたり$0.02から、1,000プロフィールあたり$0.01からになり、クレジットカード不要で有効期限のない100回分の無料リクエストの1回限りの枠が、どのプランが始まる前にも40個のエンドポイントすべてを開きます。以下のセクションは、利用可能な公開データのすべてのカテゴリと、それぞれが返す正確なフィールドをカタログ化します。
このページの内容
- Twitter/X API からどんなデータを取得できる？
- プロフィールとアカウントのデータ
- ツイートの内容とエンゲージメント指標
- 検索と過去のデータ
- 音声スペースのデータ
- リストとコミュニティ
- ユーザーのアクションを検証する
- アカウント識別子のユーティリティ
- Twitter/X API から取得できないもの
- API を通じて投稿または書き込みできる？
- このデータへのアクセスにかかるコスト
- 始め方
- よくある質問
Twitter/X API からどんなデータを取得できる？ {#what-data-can-you-get-from-the-twitterx-api}
Twitter/X API は7つのコアのデータタイプをカバーします。ユーザープロフィールとそのフォロワーのグラフ、個々のツイートとそのエンゲージメント指標、キーワードとメンションの検索、音声スペース、リストとコミュニティ、フォローやリツイートのようなユーザーのアクションの検証、そして識別子の変換ユーティリティです。これのほとんどは公開の読み取りデータで、投稿とダイレクトメッセージは別の書き込みの能力です。
実際には、それは7つの取得可能なカテゴリに分かれます。
- プロフィールとフォロワーのグラフ： 表示名、自己紹介、所在地、公開の数、そして認証の状態に加えて、フォロワー、フォロー中、そして認証済みフォロワーのリスト。
- ツイートとエンゲージメント： 完全なテキスト、言語、タイムスタンプ、そしていいね、リツイート、返信、引用、表示、ブックマークの数で、メディアとリンクは構造化されたエンティティとして返される。
- 検索： 高度なコマンドを伴うキーワード、フレーズ、作者、日付の検索、メンションの追跡、そして2006年まで遡ってアーカイブに届くアカウントの検索。
- 音声スペース： タイトル、状態、作成者、管理者、スピーカー、リスナーの内訳、そしてライブのリスナーとリプレイの統計。
- リストとコミュニティ： リストのメンバー、購読者、そして投稿のフィード、そしてコミュニティのメンバー、フィード、スコープされた検索。
- アクションの検証： アカウントがフォロー、返信、引用、リポスト、またはコミュニティに参加したかどうかのブール値のチェック。
- 識別子のユーティリティ： ユーザー名、数値の ID、そしてプロフィールのリンクの間の変換。
当社が運用する API のすべてのエンドポイントは、ApiKey ヘッダーの1つのキーで認証します。プロフィールの検索と一括のツイートの取得はこう見えます。
curl -H "ApiKey: YOUR_API_KEY" \
"https://api.sorsa.io/v3/info?username=elonmusk"
curl -X POST "https://api.sorsa.io/v3/tweet-info-bulk" \
-H "ApiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tweet_links": ["1782368585664626774", "https://x.com/user/status/123"]}'
プロフィールとアカウントのデータ {#profile-and-account-data}
Twitter/X API のプロフィールデータは、アカウントの表示名、ハンドル、自己紹介、所在地、プロフィールとバナーの画像、アカウントの作成日、そして認証の状態を、アカウントが保護されているかどうかとともに含みます。また公開の数を含みます。フォロワー、フォロー中、投稿の合計、与えたいいね、そしてメディアです。フォロワーとフォロー中のリストは、完全なプロフィールのページ分割されたセットとして利用できます。
これらは、オーディエンスと競合の調査に最もリクエストされるフィールドです。1回の /info 呼び出しは、完全なプロフィールを返し、followers_count、followings_count、tweets_count、favourites_count、media_count、verified、protected、ISO 8601 形式の created_at、location、自己紹介にあるすべての URL、そして固定されたツイートの ID を含みます。フォロワーのグラフには、/followers と /follows がリクエストあたり最大200のプロフィールを返し、/verified-followers がリストを認証済みのアカウントだけに絞ります。フォロワーとフォロー中のリストを引く方法が、ページネーションとリクエスト単位の経済性をカバーします。
見落としやすいフィールドが1つあります。アカウントの国です。/about エンドポイントは正確に3つの値を返します。アカウントに関連付けられた国、ユーザー名の変更の合計回数、そして最も最近の変更の日付です。その国のフィールドが、アカウントがどこを拠点とするかのチェックを動かすものです。
ツイートの内容とエンゲージメント指標 {#tweet-content-and-engagement-metrics}
任意の公開の投稿について、Twitter/X API は、完全なテキスト、言語、タイムスタンプ、そしてそれが属する会話を、エンゲージメント指標とともに返します。いいね、リツイート、返信、引用、表示、そしてブックマークです。添付されたメディアとリンクは構造化されたエンティティとして返ります。返信、引用、リポストには、元の投稿とその作者が応答にネストされます。
表示回数は2022年12月から投稿で利用可能で、likes_count、retweet_count、reply_count、quote_count、そして bookmark_count と並んで view_count として返されます。1回の /tweet-info 呼び出しは1つの投稿を返します。/tweet-info-bulk は最大100の投稿 ID を受け付け、それらすべてを単一のリクエストで返し、それが1回の課金される呼び出しと100回の違いです。タイムラインを引くには、/user-tweets がユーザーの投稿をページごとに返し、一方 /comments、/quotes、そして /retweeters が、与えられた投稿の下の返信、引用の投稿、そしてリポストするアカウントを返します。API を通じて返信、引用、リポスト者を扱うが、これらのエンドポイントそれぞれをより深く扱います。
取得できないエンゲージメントのシグナルが1つあります。投稿にいいねしたアカウントのリストです。X（旧Twitter）は2024年6月12日にいいねを非公開にしたため、いいねの数だけが公開され、その背後の身元は公開されません。リツイート、引用、または返信したアカウントは依然として取得できます。
長文の投稿も利用できます。X アーティクルの完全なテキストを引くは、記事の本文、カバー画像、そして指標を返し、場所別のトレンドのトピックは、与えられた地域の現在のトレンドを返します。
検索と過去のデータ {#search-and-historical-data}
Twitter/X API は、高度な検索コマンドを使って、キーワード、フレーズ、ハッシュタグ、作者、そして日付で公開の投稿を検索し、特定のハンドルをメンションする投稿を返し、キーワードでアカウントを検索できます。検索は、最近の投稿だけでなく2006年まで遡る完全な公開のアーカイブに届くため、過去の研究が可能です。
検索はコマンドの構文が重要になるところです。/search-tweets は、from:、to:、since:、until:、引用符の完全なフレーズ、そしてハッシュタグを含む、Twitter の検索と同じ高度なコマンドを受け付け、popular または latest の順序でページあたりおよそ20の投稿を返します。ツイート検索 API の高度な検索コマンドのリファレンスが、クエリの構築を案内します。
ブランドと評判の作業には、/mentions がハンドルをメンションする投稿を返し、どの検索エンドポイントよりも豊かなフィルターのセットを提供します。最小のいいね、返信、リツイート、そして since_date と until_date の境界です。規模でメンションを追跡するが、フィルターをカバーします。今週ではなく何年も前の投稿が必要なときは、より古いツイートのアーカイブを検索するが、日付で区切ったクエリがどうプラットフォームの最も初期の投稿に届くかを説明します。
音声スペースのデータ {#audio-spaces-data}
Twitter/X API は音声スペースのデータを返します。タイトル、現在の状態、スケジュールされた開始時刻、作成者の完全なプロフィール、そして管理者、スピーカー、リスナーとしての役割別の参加者の内訳です。また、アクセス設定とライブの統計を公開し、合計とピークのリスナーとリプレイの表示を含みます。
1回の /spaces 呼び出しは、スペースの ID またはリンクを取り、完全なオブジェクトを返します。ほとんどのエンドポイントと異なり、スペースのタイムスタンプは ISO 8601 の文字列ではなく Unix の整数で、created_at、scheduled_start、そして参加者の参加時刻を解析するとき、明示的に扱う価値のある詳細です。参加者の内訳は、どのアカウントがホストまたは話したか、単に聞いたかを見つけるのに有用です。
リストとコミュニティ {#lists-and-communities}
Twitter/X API は Twitter/X のリストとコミュニティを公開します。リストについては、そのメンバーのプロフィール、その購読者、そしてそのメンバーからの投稿のフィードを取得できます。コミュニティについては、そのメンバー、その投稿のフィード、そしてそのコミュニティだけにスコープされたキーワード検索を実行できます。
リストは、固定のアカウントのセットを追跡するきれいな方法です。/list-members はリストのプロフィールを返し、/list-followers はそれに購読しているアカウントを返し、/list-tweets はそのメンバーからの投稿の結合されたフィードを返します。コミュニティは /community-members、/community-tweets、そして /community-search-tweets を通じて同じように動き、最後のものはキーワード検索を単一のコミュニティに制限します。リストとコミュニティからメンバー、投稿、フォロワーを抽出するが、両方を1か所でカバーします。
ユーザーのアクションを検証する {#verifying-user-actions}
生のデータを超えて、Twitter/X API は特定のユーザーのアクションを検証できます。1つのアカウントが別のアカウントをフォローするか、ユーザーが与えられた投稿に返信したか、それを引用またはリポストしたか、そして特定のコミュニティに属するかです。各チェックはブール値の結果を返し、それがプレゼント企画とキャンペーンの検証が頼るものです。
これらのチェックは、プレゼント企画とキャンペーンの監査の背骨です。/check-follow は1つのアカウントが別のアカウントをフォローするかを確認し、/check-comment は特定の投稿の下の返信を確認し、/check-quoted と /check-retweet は引用とリポストを確認し、/check-community-member はメンバーシップを確認します。単一のチェックは一方向なので、双方向のフォローのチェックは、各方向に1回ずつ、2回の呼び出しを取ります。キャンペーンのためにフォロー、返信、引用、リポストを検証するが、完全なワークフローをカバーします。
アカウント識別子のユーティリティ {#account-identifier-utilities}
Twitter/X API は識別子の変換も扱います。ユーザー名をその永続的な数値のユーザー ID に変換し、数値の ID を現在のユーザー名に戻し、プロフィールの URL からユーザー ID を抽出できます。ユーザー名は変わり得ますが数値の ID はけっして変わらないため、ID を保存することが、時間をかけてアカウントを追跡する信頼できる方法です。
ユーザー名は変わります。サインアップ時に割り当てられた数値の ID は変わりません。/username-to-id と /id-to-username が2つの間を変換し、/link-to-id がプロフィールの URL からまっすぐ ID を引きます。ユーザー名、ユーザー ID、そしてプロフィールのリンクの間を変換するが、なぜ ID ベースの保存がハンドルの変更を生き延びるかを説明します。別の /key-usage-info 呼び出しが、キーに残っているリクエストの数を報告します。
Twitter/X API から取得できないもの {#what-you-cannot-get-from-the-twitterx-api}
一部のデータは、どの API でも立ち入り禁止です。他のユーザーのダイレクトメッセージを読み、フォローしていない保護されたアカウントからコンテンツを取得し、または削除された投稿を回復することはできません。X が2024年6月にいいねを非公開にしたため、投稿にいいねしたアカウントのリストを取得できません。読み取り専用の API はさらに、投稿、返信、フォロー、またはメッセージの送信ができません。
境界を知ることは無駄な呼び出しを省きます。非公開と保護されたアカウントは、ログアウトした閲覧者が見るものだけを返し、削除された投稿はインデックスから消え、他のユーザー間のダイレクトメッセージはけっして公開されません。いいねの制限はエンゲージメントの監査を最も頻繁につまずかせます。投稿のいいねの数は得られますがその背後のアカウントは得られないため、オーディエンスの分析は代わりにフォロワー、返信者、引用者、そしてリポスト者に頼ります。読み取り専用の制限は意図的な設計の選択で、次のセクションで扱います。
API を通じて投稿または書き込みできる？ {#can-you-post-or-write-through-the-api}
公式 X API は書き込みのアクションをサポートします。投稿、返信、そしてダイレクトメッセージの送信で、すべてリクエスト単位で課金されます。2026年4月20日時点で、フォロー、いいね、そして引用投稿の書き込みはエンタープライズ専用のアクセスに移りました。読み取り専用のサードパーティ API はまったく書き込みません。公開データを取得し、それ以外は何もせず、それが接続されたアカウントへの書き込み権限のリスクを取り除きます。
書き込みが必要かどうかが、API を選ぶ最初の分岐点です。目標が公開または自動化なら、公式 X API が経路で、プレーンなメッセージの投稿はリクエストあたり$0.015、URL を含む投稿は$0.20かかります。目標が公開データを量で読むことなら、書き込みの能力は不要な重荷で、Sorsa が運用するような読み取り専用の API はそれを意図的に手放します。投稿がないことは、OAuth の書き込みスコープなし、アプリ権限のレビューなし、そしてトークンがアカウントに意図しない何かをするリスクなしを意味します。移行を検討するチームには、公式 X API から移行するが読み取りのエンドポイントを対応付けます。
このデータへのアクセスにかかるコスト {#what-it-costs-to-access-this-data}
Twitter/X データのコストは、量だけでなく課金モデルに依存します。公式 X API はリソース単位で課金します。投稿読み取りあたり$0.005、プロフィール読み取りあたり$0.010なので、20の投稿にその作者を加えて返す1回の検索は約$0.30かかります。リクエスト単位でフラットな API は、いくつの項目が返るかに関わらず呼び出しごとに1回課金し、それが読み取りの重い作業に有利です。
読み取りの重いアクセスには、量が月およそ10,000投稿読み取りを超えると、リクエスト単位のフラットなモデルはリソース単位の課金より劇的に安くなります。
| 側面 | 公式 X API（従量課金） | Sorsa API |
|---|---|---|
| 課金モデル | 取得したリソース単位 | リクエスト単位、フラット |
| 1,000ツイート（バッチ） | $5.00 | Pro で約$0.02 |
| 1,000プロフィール（バッチ） | $10.00 | Pro で約$0.01 |
| ツイート応答の中の作者プロフィール | 別のプロフィール読み取りとして課金 | 無料で含まれる |
| 公開データへの読み取りアクセス | はい | はい |
| 書き込みアクセス（投稿、DM） | はい、フォロー・いいね・引用投稿は2026年4月以降エンタープライズ専用 | なし、読み取り専用 |
| レート制限 | 15分あたり300リクエスト、エンドポイントで変動 | すべてのプランで毎秒20リクエスト |
| 認証 | Bearer トークンを伴う OAuth 2.0 | ヘッダーの1つの API キー |
| バッチリクエスト | 限定的 | 1呼び出しあたり最大100ツイートまたは100プロフィール |
| 月間の上限 | 200万投稿読み取り | プラン依存、10,000〜500,000リクエスト |
投稿、フィルターされたストリーミング、またはエンタープライズのコンプライアンス契約が必要なら、公式 X API が正しいツールです。公開データへの、フラットで予測可能な価格での読み取りの重いアクセスには、フラットレートのプロバイダーが勝ち、データユニット単位のギャップがその理由です。Sorsa の料金がプランをリストし、2026年の X API 料金の完全な分解がリソース単位の計算を詳細に示します。
リソース単位の課金をやめたチーム {#a-team-that-switched-off-per-resource-billing}
およそ10人のソーシャル分析チームが、公式 X API の上で直接1か月構築した後に Sorsa のところに相談してきました。このチームの製品は、追跡する数千のアカウントにわたってプロフィール、最近の投稿、そしてエンゲージメント指標を引き、すべての投稿読み取りにすべての作者プロフィールを加えて別々に数えるリソース単位の請求が、料金が吸収できるものを超えて上っていました。同じ読み取りのワークロードを、各ツイート応答にすでに作者データが含まれ、バッチエンドポイントが100項目の取得を単一のリクエストに畳むリクエスト単位のフラットな呼び出しに移すことで、データコストは最大50分の1に下がりました。支払っていた書き込みの機能は、けっして使っていませんでした。
始め方 {#getting-started}
必要なものを正しいエンドポイントに対応付けることが、プロジェクトをスコープする最も速い方法です。上の読み取り専用のデータは、1つの API キーで40個のエンドポイントを通じて、すべてのプランで一律の毎秒20リクエストと数分でのセットアップ、アプリのレビューなしで利用できます。クレジットカード不要で有効期限のない100回分の無料リクエストの1回限りの枠が、支払う前にすべてのエンドポイントをテストのために開きます。ブラウザベースの API プレイグラウンドで任意のエンドポイントをテストし、統合の準備ができたらエンドポイントのリファレンスを読みます。データはバッチエンドポイントで1,000ツイートあたり$0.02から、1,000プロフィールあたり$0.01からで、プランは10,000リクエストで月額$49から500,000で$899までです。
よくある質問 {#frequently-asked-questions}
Twitter/X API から表示回数とブックマーク数を取得できる？
はい。Twitter/X API は、2022年12月から利用可能な投稿の表示回数と、ブックマーク数を、標準のいいね、リツイート、返信、引用と並んで返します。これらは各投稿オブジェクトの数値のフィールドとして返ります。利用できない唯一のエンゲージメントのシグナルは、投稿にいいねしたアカウントのリストで、2024年6月に非公開になりました。
Twitter/X API を通じてツイートを投稿できる？
公式 X API は、リクエスト単位で課金される投稿、返信、そしてダイレクトメッセージをサポートしますが、フォロー、いいね、そして引用投稿の書き込みは2026年4月にエンタープライズ専用のアクセスに移りました。読み取り専用のサードパーティ API はまったく投稿しません。プロジェクトが公開データを読むだけなら、書き込みアクセスは不要で、避けられる権限のリスクを加えます。
API を通じて Twitter/X データを取得する最も安い方法は？
読み取りの重い作業には、月およそ10,000投稿読み取りを超えると、リクエスト単位のフラットな API が最も安い経路です。Sorsa は、いくつの項目が返るかに関わらず呼び出しごとに1リクエストを課金し、ツイート応答に作者プロフィールを含み、それがバッチエンドポイントで1,000ツイートあたり$0.02から、1,000プロフィールあたり$0.01からになり、公式 API の投稿読み取りあたり$0.005とプロフィール読み取りあたり$0.010に対してです。クレジットカード不要の100回分の無料リクエストの1回限りの枠が、支払う前にすべてのエンドポイントをテストさせます。
Twitter/X API のデータはどこまで遡る？
検索は、最近の投稿だけでなく、Twitter がローンチした年である2006年まで遡る完全な公開のアーカイブに届きます。since や until のようなコマンドを使った日付で区切ったクエリは、特定の過去の窓を標的にできます。リアルタイムと過去のデータは同じ検索エンドポイントを使うため、1つのクエリが最近または古い投稿のどちらにもまたがれます。
Twitter/X API のデータにアクセスするのに開発者アカウントが必要？
公式 X API は、どのデータの呼び出しの前にも、開発者アカウント、承認されたアプリ、そして OAuth のフローを必要とします。Sorsa のようなフラットレートのプロバイダーはそれを取り除きます。リクエストヘッダーの1つの API キーがすべてのエンドポイントを認証し、アプリのレビューなしで数分でのセットアップです。この方法で公開の X データを読むことは、プラットフォームの開発者プログラムを必要としません。
Twitter/X API から取得できないデータは？
他のユーザーのダイレクトメッセージを読み、フォローしていない保護されたアカウントからコンテンツを見て、削除された投稿を回復し、または投稿にいいねしたアカウントのリストを取得することはできません。いいねが2024年6月に非公開になったからです。エンゲージメントの監査は、いいねした人の代わりにフォロワー、返信者、引用者、そしてリポスト者に頼ります。
監修：Keksich（Sorsa創業者、マーケター兼X APIリサーチャー）
本ガイドは、Sorsa の読み取り専用の X API とその公開のドキュメントを運用する日々の作業に基づき、X の公表された2026年の従量課金の料金と2024年6月のいいねのプライバシーの変更に対してクロスチェックしています。エンドポイント名、応答のフィールド、そして制限は稼働中の API に対して確認し、料金は X の2026年4月20日の更新後に有効なレートを反映します。これらのガイドの背後のチームについてのより多くは、Sorsa の About ページにあります。2026年7月8日確認。