SNS

X(旧Twitter)

Twitter API（X API）完全ガイド：登録・認証・活用まで初心者でもわかる

2025/07/20 2026/08/12

Twitter API（X API）の開発者登録からOAuth認証方式の選び方、Tweepyの実装例、レート制限エラーの対処法まで。初心者でも迷わない手順と注意点をまとめて解説します。

Twitter APIは、SNS運用やデータ分析において有用なツールです。自動投稿やツイート収集といった自動化から、ソーシャルリスニングやユーザー行動の可視化まで、幅広い活用が可能です。一方で、2026年現在の仕様は複雑化しており、バージョンの違いや利用制限、認証方式の選定など、初心者にとってはわかりづらい点も多く存在します。

Twitter APIは2023年以降に大幅な仕様変更が行われ、無料プランの廃止や有料プランへの移行など、利用環境が大きく変化しました。 そのため、以前の情報をもとに導入を検討すると、現在の仕様と食い違いが生じる場合があります。最新のプラン体系や制限事項を正確に把握したうえで利用を検討することが重要です。

本記事では、X API（旧Twitter API） の基本概念から最新の利用プラン、導入方法、活用例、注意点までを体系的に解説します。SNS担当者や中小企業の経営者の方が、自社のマーケティング施策に活用できるかどうかを判断するための情報を、わかりやすく整理しています。

1 Twitter API（X API）とは？基本をやさしく解説
2 Twitter APIの利用プラン一覧と無料枠でできること
3 Twitter APIの導入ステップ【開発者登録〜キー取得】
4 Twitter APIの使い方：curlとPythonスクリプト解説（2026年版）
5 Twitter APIを活用するメリットと活用例
6 Twitter APIの注意点と制限まとめ【2026年版】
7 TwitterAPIに関するよくある質問
8 あわせて読みたい
9 まとめ

Twitter API（X API）とは？基本をやさしく解説

Twitter APIの定義とできること一覧

Twitter API（X API）とは、SNSプラットフォーム「X（旧Twitter）」が提供する開発者向けインターフェースで、アプリケーションやシステムからXの各種データを取得・操作できる仕組みです。具体的には、以下のような操作が可能です。

ツイート（ポスト）の検索や取得
ユーザー情報の参照
ポストの投稿や削除
自動返信
フォロー関係の管理
トレンド分析

API（Application Programming Interface）は、外部からの命令に応じてデータをやり取りするための窓口です。X APIはX上の操作を自動化・効率化する窓口として、マーケティング・学術研究・BOT開発・顧客対応といった多様な分野で活用されています。

たとえば、ポスト内容を収集してキーワードの出現傾向を分析したり、自動で定期投稿を行ったり、フォロワーの属性データを抽出してレポート化したりできます。ツール開発やデータ分析、SNS運用の効率化を目指す方にとって、X APIは実用的な技術的手段のひとつです。

v2 APIとv1.1の違い・2026年の最新仕様とは

Twitter APIには、かつての〈v1.1〉と現在主流の〈v2〉という2つのバージョンがあります。旧バージョンであるv1.1は長らくAPIの標準でしたが、仕様の複雑さや機能の制限があり、開発者の間で柔軟性に欠けるという指摘がありました。これを受けて登場したのが、現在の主流であるv2 APIです。2026年時点では、v2がすべての新規機能の対象となり、v1.1のエンドポイントは段階的に廃止されています。

v2の最大の特徴は、構造と認証方式の柔軟化です。取得したい情報（メタデータやユーザー情報）を必要な分だけ選べるfieldパラメータや、expansionsでリプライ元・引用元の情報も同時に取得できる設計が導入されています。これにより、データの最適化と通信量の削減が可能になりました。

認証方式も刷新され、v1.1で一般的だったOAuth 1.0aに加えて、OAuth 2.0（App-only／User-based）が正式に対応し、よりセキュアな接続が可能になっています。リアルタイムのストリーミング機能であるFiltered Stream Webhooks APIもv2に統合されており、開発者はこれを使って公開ポストを条件付きでほぼリアルタイムに受信できます。最大1,000個のフィルタリングルールを定義でき、条件に合致するポストのみを効率的に取得できる点が特徴です。

2026年最新：料金体系はPay-Per-Use（従量課金制）に移行

X APIは2026年2月より「Pay-Per-Use」従量課金制に移行しました。月額固定プランは廃止され、使用した分のみ請求される仕組みです。

2026年5月31日時点のX API公式仕様によるリソース別の主な単価は以下のとおりです。

リソース種別	単価（目安）
Read（読み取り）	$0.005〜$0.010 / 件
Owned Reads（自己アカウント読み取り）	$0.001 / 件
Post creation（投稿作成）	$0.015 / 件
URL付き投稿	$0.200 / 件

なお、月間2Mポスト読み取りのハードキャップ（上限）が設定されており、レート制限は15分単位と月単位の2軸で管理されています。 利用規模によってはコストが想定より膨らむ可能性があるため、事前に利用量の見積もりを立てた上で導入を検討することをおすすめします。

また、X APIクレジットを購入すると、支出額に応じて最大20%のxAI APIクレジット還元を受けられる制度も設けられています（条件・上限については公式ドキュメントを要確認）。

これからX APIを使う開発者・マーケターは、v2での設計を前提に、新しい従量課金体系を踏まえたコスト管理の計画が必要です。

Twitter APIの利用プラン一覧と無料枠でできること

Twitter APIの料金プラン概要（Free／Basic／Pro／Enterprise）

Twitter（X）APIには、2026年2月以降、新規開発者向けにはPay-Per-Use（従量課金）と Enterprise の2つのアクセス経路のみが用意されています。旧来のFree／Basic／Proの固定月額プランは新規登録が終了しており、既存契約者のみが引き続き利用できます（BasicはJune 2026より既存ユーザーも順次Pay-Per-Useへ強制移行）。公式ドキュメントによれば、各プランの特徴は以下の通りです。

プラン	料金	内容
Pay-Per-Use（新規登録のデフォルト）	月額固定なし（クレジット購入制）	ポスト読取$0.005/件、ユーザー情報読取$0.010/件、投稿$0.015/件、URL付き投稿$0.200/件。月間2,000,000ポスト読取のハードキャップあり。Filtered Stream・Full-Archive検索は非対応
Basic	月200ドル（新規登録終了・既存ユーザーも2026年6月以降Pay-Per-Useへ移行中）	投稿50,000件/月・読取15,000件/月。Filtered Stream非対応
Pro	月5,000ドル（新規登録終了・既存ユーザーのみ）	投稿300,000件/月・読取1,000,000件/月。Filtered Stream・Full-Archive検索利用可
Enterprise	月額42,000ドル以上（規模・使用量に応じて変動）	ストリーミングや過去データ取得、カスタムサポートや広告API、各種専用エンドポイントも含まれます

無料プランでできることと制限（取得・投稿など）

無料（Free）プランは、v2エンドポイントの基本機能にアクセスできる点で魅力ですが、多くの制約があります。具体的には、以下のようなものがあります。

投稿（POST）：月500件まで。Botによる自動投稿や返信は可能ですが、大量運用には不向きです
読み取り（READ）：v2での基本的な検索・取得は可能ですが、Filtered StreamやFull-Archive検索機能は利用不可。v1.1も制限付きアクセスのみ利用可能
プロジェクト・アプリ数：1プロジェクト・1アプリ。開発者アカウントが1種類のアプリしか扱えず、環境分けが困難です。
レート制限：各エンドポイントへのアクセス頻度は低いため、商用利用や高頻度の処理には適していません。

したがって、趣味・検証・学習レベルでの利用には十分ですが、実用的な自動化や分析に使うにはすぐ上位プランへの移行が必要です。

有料プランでできることの比較と選び方

Basic／Pro／Enterpriseプランにより、用途や規模に応じた選択が可能です。

Basic（200ドル／月・新規登録終了）：過去7日間の検索が可能になり、v2 APIの基本機能は利用できますが、Filtered Streamは非対応。投稿数50,000件/月・読取15,000件/月。ライトなBot運用・データ取得には十分でしたが、現在は新規登録不可です。
Pro（5,000ドル／月・新規登録終了）：Basicの機能に加えて、読取数100万件/月（投稿は300,000件/月）、フルアーカイブ検索、Filtered Stream、より高頻度のアクセスが可能です。大規模キャンペーン・分析プラットフォームなどに適します
Enterprise（42,000ドル〜／月）：無制限のストリーミング、完全アーカイブ取得、高度なサポートやエンタープライズ向けツールが含まれます。大手企業・研究機関・AI解析用途など大規模運用を目的とした組織に最適。

選び方のポイント

利用目的：Botの自動投稿／モニタリング等ならBasic、AI・分析用途ならPro以上を推奨。
予算：Basicは200ドル／月、Proは5,000ドル、Enterpriseは大規模導入向け。
データ量と頻度：取得頻度や期間、投稿数に応じてプランを選定。軽量用途ならBasic、大量データならProまたはEnterpriseが必要。

Twitter APIの導入ステップ【開発者登録〜キー取得】

Twitter Developer Portalでの登録手順

Twitter API（現X API）を利用するには、まずconsole.x.comで開発者アカウントを登録する必要があります。これにより、APIへのアクセス権を持つ「プロジェクト」と「アプリ」を作成できます。登録の流れは以下の通りです。

console.x.com にアクセスし、XアカウントでサインインしてDeveloper Portalを開く
Developer Agreement and Policy を確認し、同意する
API利用方法について基本情報（氏名・国・用途概要）を入力する
API使用の詳細（自動投稿や分析の有無など）を記入し、ポリシーへの同意を確認
メールアドレスの認証リンクを確認し、登録完了

2026年時点では、申請内容が不明瞭な場合に承認されないケースがあります。特にBot開発や自動投稿の用途では、詳細な説明や守秘義務の遵守を明記することでスムーズな審査通過につながります。また、2026年2月以降の新規登録では、250文字以上の使用目的の説明、Developer Agreementの承認、プロジェクトとアプリの作成、支払い方法の追加がすべて必須となっています。

登録完了後は、Developer Console内で「プロジェクト」を作成し、その中にAPIを操作するための「アプリ」を1つ以上作成するという流れになります。

APIキー・Bearer Token取得までの6ステップ

アカウント登録後は、APIを操作するための「キー情報」を取得する必要があります。具体的には以下の6ステップで進めます。

Developer Console のダッシュボードから対象の「アプリ」を選択する
「Keys and tokens」タブを開く
「Consumer Key（API Key）」と「Consumer Secret（API Secret）」を取得する
「Authentication settings」で「OAuth 2.0」か「OAuth 1.0a」を設定する
「Bearer Token」を生成してコピーする
アクセス制御の設定（Read／Write権限の付与）を確認する

このキー情報は、実際のAPIアクセス時にcurlやPythonライブラリから認証用として使います。Bearer Tokenは特にv2 APIで広く利用されるトークン型認証で、アプリ単位で固定されます。

APIキーは生成時に一度しか表示されません。必ずパスワードマネージャーや安全なボルト（Secrets Managerなど）に即時保管してください。 GitHub等の公開リポジトリに誤って含めると第三者による不正利用のリスクがあるため、環境変数での管理を推奨します。

認証方式（OAuth 2.0とBearer Token）を理解する

X APIでは、用途や操作対象によって異なる認証方式が用意されています。2026年時点では以下の4種類が提供されており、新規開発にはOAuth 2.0が推奨されています。

認証方式	主な用途	特徴
Bearer Token（OAuth 2.0 App-Only）	読み取り専用のデータ取得	最もシンプル。v2 APIで広く利用
OAuth 2.0 Client ID（ユーザー委譲フロー）	ユーザー委譲による投稿・DM送信など	最新標準。新規開発に推奨
Access Token	アカウントレベルの書き込み操作	ユーザーのアクセストークンを用いる
OAuth 1.0a（API Key＋Secret）	v1.1 APIでの投稿・操作	署名付きリクエストが必要。やや実装が複雑

用途に応じた認証方式の選び方は次の通りです。

ツイート取得のみの分析用途 → Bearer Token（OAuth 2.0 App-Only）で十分
Botとして投稿・削除まで行いたい場合 → OAuth 2.0 ユーザー委譲フロー（Client ID）またはAccess Tokenを使用
既存のv1.1 API連携を維持する場合 → OAuth 1.0a（API Key＋Secret）を引き続き利用可能

なお、2026年2月6日以降、X APIの料金体系は従来の固定月額ティアから従量課金（pay-per-use）モデルに移行しており、新規開発者は無料ティアなしで従量課金のみで登録します。固定の月額費用や月額上限はなく、利用量に応じた課金となるため、開発開始前に公式の料金ページで最新の単価を確認することをおすすめします。

Twitter APIの使い方：curlとPythonスクリプト解説（2026年版）

curlでRecent Search APIを叩いてみよう（初心者向け）

Twitter API（現X API）は、curlを使って直接コマンドラインから利用できます。特に〈Recent Search API〉は、過去7日以内のポストを検索できる機能で、キーワードによるデータ収集が手軽に行える点で初心者にもおすすめです。

curlはプログラミング不要で、パラメータとURLを指定するだけでAPIにアクセスできます。たとえば「特定のキーワードを含む最新ポストを取得する」操作も、ターミナルに1行入力するだけで実行可能です。実行後はポスト本文や投稿日時、ユーザー名などの情報がJSON形式で出力され、分析や報告に活用できます。

2026年2月以降、新規作成のX Developerアカウントは自動的に「Pay-Per-Use（従量課金）」モデルに登録されます。完全無料の選択肢はなくなっているため、APIを呼び出す前に料金体系を確認しておきましょう。取得データをそのままファイルに保存したり、後続の集計処理に活用するなど、運用の幅は十分にあります。簡易的にAPIを体験したい方は、まずcurlからの活用を試してみるとよいでしょう。

#### 2026年版 Pay-Per-Useの主な料金レート

X公式ドキュメント（docs.x.com, 2026年5月23日確認）によると、Pay-Per-Useモデルの主な単価は以下のとおりです。

操作	単価（USD）
ポスト読み取り	$0.005 / 件
ユーザー情報読み取り	$0.010 / 件
URLなしポスト投稿	$0.015 / 件
URLありポスト投稿	$0.200 / 件

固定月額の階層型プラン（Basic・Pro）は新規登録が終了しており、既存ユーザーのみ継続利用可能です。新規開発者はPay-Per-UseまたはEnterpriseから選択することになります。

Python＋requestsライブラリでFiltered Streamを実装する方法

実務で継続的なデータ取得や自動化を行う場合、X API v2に対応したPythonでの実装が広く使われています。2026年版では、特にリアルタイムにポストを受信できる〈Filtered Stream〉をPython標準のrequestsライブラリで実装するケースが増えています。

Filtered Streamは、キーワード・ハッシュタグ・URLなどのポスト属性に基づいてフィルタリングルールを設定し、条件に合致するポストをリアルタイムで受信できる機能です。認証にはBearer Tokenを使用し、接続維持のためストリームは20秒ごとに空行（\r\n）を送信するキープアライブ仕様となっています。20秒間データもキープアライブも受信しない場合は、クライアント側からの再接続が必要です。

従来広く使われてきたTweepyも引き続き有効な選択肢ですが、requestsライブラリによる直接実装はライブラリへの依存を減らせるメリットがあります。 フィルタルールの作成・管理には既存のv2フィルタルール管理エンドポイント（POST /2/tweets/search/stream/rulesなど）を使用します。取得したデータはCSVやExcelに出力したり、可視化ツールに連携して分析用途に展開することも可能です。

#### エラー対処：429エラーの3つのパターン

API利用時に遭遇しやすい429エラー（レート制限超過）には、2026年時点で以下の3種類があります（twitterapi.io, 2026年5月確認）。

エラーの種類	原因	目安の復旧タイミング
短期ウィンドウキャップ	15分以内のリクエスト過多	15分以内
月別キャップ超過	月間リクエスト上限を超過	翌月初
支出上限到達（2026年新設）	Pay-Per-Useの設定上限額に到達	上限額変更後（403が返ることもある）

特に支出上限到達は2026年から新設されたパターンです。429ではなく403エラーが返るケースもあるため、エラーハンドリングの実装時には両方を考慮してください。

Twitter APIを活用するメリットと活用例

自動化・分析に活かせるAPI活用パターンとは？

Twitter APIを導入することで、SNS運用やデータ活用を自動化・効率化できる点が最大のメリットです。たとえば、決まった時刻に投稿する定期Bot、ユーザーの投稿に応じて返信するサポートBotなど、自動運用によって人的リソースを大幅に削減できます。

また、ツイートの収集・解析によって、商品やブランドに対する言及の傾向を把握する「ソーシャルリスニング」や、話題の変遷を追跡する「トレンド分析」などにも活用可能です。キャンペーンの効果測定、ユーザーの感情傾向の可視化など、マーケティング領域での応用も広がっています。

こうした活用は、データをもとにした意思決定を支えるだけでなく、レポート作成や業務フローの自動化にもつながるため、実務に直結した効果を発揮します。

開発者・研究者がAPIでできること（Bot・可視化など）

Twitter APIは開発者にとって、Bot開発や可視化システムの構築に欠かせないツールです。自動投稿Botやキーワード監視Bot、アカウント分析ダッシュボードなど、APIを通じてリアルタイムにTwitterと連携するサービスが数多く作られています。

また、研究者にとっては、大量のツイートデータを取得して自然言語処理・社会分析に活用する手段として重宝されています。政治的発言や災害時の反応、イベント拡散の可視化など、SNS上の行動パターンを定量的に捉えるための基盤として利用されています。

これらは単なる技術的応用にとどまらず、社会的インサイトやユーザー行動の理解を深める手段として、学術的にも実務的にも価値の高い活用例です。

Twitter APIの注意点と制限まとめ【2026年版】

レートリミットと有料プランの違いに注意

Twitter（X）APIを使う際に注意すべき点の一つが「レートリミット（利用制限）」です。これは、一定時間内にAPIを何回まで呼び出せるかを制限する仕組みで、プランによって大きく異なります。X API v2では15分単位のリクエストレート制限と、月単位の投稿読取消費制限の両方が課されています。

2026年2月にはX APIへ従量課金制（使った分だけ支払う方式）が導入され、料金体系が大きく変わりました。 従量課金モデルではあらかじめクレジットを購入し、APIを実行するたびに残高が消費される仕組みのため、用途によってコストが変動します。 pay-per-useプランでは無料の読取枠がなく、投稿の読取は1件あたり$0.005、ユーザー情報の読取は$0.010から課金されます。

また、pay-per-useプランには月間2,000,000投稿読取のハードキャップ（上限）が設定されており、無制限の読み取りは制度的に制限されています。 自分の用途に合ったリクエスト回数やコスト試算を事前に確認し、業務への影響を把握したうえでプランを選択することが重要です。

仕様変更・廃止されたAPIに要注意（v1.1・エンドポイント）

Twitter APIは仕様変更が頻繁に行われるため、過去に使われていたAPIが突然廃止されたり、挙動が変更されることがあります。特にv1.1のエンドポイントは2026年現在、多くが非推奨・廃止対象とされており、これまで利用できた操作が使えなくなるケースもあります。

タイムラインの取得やフォロー操作など、一部のv1.1の機能はv2では異なる形式で提供されているため、開発者は常に最新のドキュメントを確認する必要があります。API移行時にはレスポンス形式や認証方式が変わることもあるため、既存のスクリプトを修正しなければならないケースも想定されます。

また、2026年4月からDeveloper Portalでの新規アプリ作成は1日最大3件までに制限されました。 Xは仕様変更の通知を公式ポータルや開発者向けニュースレターで配信しています。安定的な運用を行うには、これらを定期的にチェックする習慣を持つことが重要です。

Filtered Stream利用時の注意点

Filtered Stream v2は、2026年時点でFreeプラン・Basicプラン・pay-per-useプランでは利用できません。 公式で利用可能な最小プランはProプランで、月額$5,000からとなっています。 リアルタイムでツイートをストリーミング取得したい場合は、この費用水準を前提に計画を立てる必要があります。

Filtered Streamには1接続あたり最大250投稿/秒の制限があります。 大量データのリアルタイム収集を想定している場合は、この上限を超えないように設計することが求められます。コスト・制限の両面から、Filtered Streamの利用が自社の用途に見合うかどうかを事前に十分検討してください。

API利用時の禁止事項とポリシー違反リスク

Twitter APIは利用規約と開発者ポリシーに基づいて運用する必要があり、違反した場合はアプリの停止やAPIキーの剥奪といったペナルティを受けることがあります。特に、スパム的投稿・同一内容の大量送信・過度な自動操作などは禁止対象です。

ユーザーの同意なく個人情報を収集・公開する行為や、Xの利用規約に反する行為（ヘイトスピーチの拡散など）も厳しく規制されています。APIを使って開発を行う場合は、事前に「X Developer Agreement」や「Automation Rules」などのガイドラインを確認し、違反がないよう設計することが不可欠です。

近年では、AIや自動化の発展に伴い、意図せずポリシー違反と判定されて運用停止になるケースも発生しています。問い合わせフォームやサポートチャネルも積極的に活用し、リスクを最小限に抑える姿勢が求められます。

TwitterAPIに関するよくある質問

Twitter APIは無料でどこまで使えますか？

無料プランでできることは、月500件までの投稿と、限られたエンドポイントへのアクセスのみです。高頻度のデータ取得や商用利用には対応しておらず、Botの開発や学習目的など、リクエスト数が少ない軽量な用途に限って実用的です。商用や本格運用を検討している場合は、有料プランへの移行を前提に計画することをおすすめします。

APIの利用にはどれくらいのプログラミング知識が必要ですか？

HTTPリクエストの基本構造とOAuth認証の仕組みを理解できれば、curlや簡単なスクリプトで動作確認が可能です。PythonライブラリのTweepyを使うと記述量がさらに減り、初心者でも数十行のコードで実装できます。ただし、エラー処理やレート制限（一定時間内のリクエスト上限）への対応には、ある程度の経験があると作業がスムーズになります。

開発者登録にあたって審査はありますか？

はい、開発者登録には審査があります。特に自動投稿やデータ収集を目的とする場合は審査が厳しくなる傾向があり、具体的な使用目的やポリシー遵守方針を明記しないと承認されないことがあります。申請時は用途を曖昧にせず、実際の利用シナリオを具体的に記述することが承認への近道です。

Xの投稿、“続ける”のがしんどくなっていませんか？

毎日の投稿ネタ、そろそろ尽きていませんか？
忙しくて投稿が止まりがちになっていませんか？
「いつ投稿すれば伸びるか」迷っていませんか？

投稿の作成から予約までAIがサポート。ネタ切れとも、投稿忘れともお別れです。

面倒な作業はAIにお任せ！月2,992円の集客支援ツールが、いまなら1週間無料！

▶ 無料で1週間ためす

まとめ

Twitter APIは、ツイートの取得・投稿・分析といった多様な操作を可能にする開発者向けツールです。無料から有料までの多様なプランが用意されており、導入にあたっては利用目的と予算に応じた適切な選択が重要です。自動化や分析といった活用例も豊富で、特にマーケティング・研究・開発の現場では、APIを使った業務効率化や情報収集が日常的に行われています。

一方で、APIにはレートリミットや利用規約、仕様変更といった制約も存在し、安定運用のためには最新情報のキャッチアップとガイドラインの順守が欠かせません。また、認証や開発者登録の手順はやや煩雑な面もあるため、段階的に理解を深めながら進めることが求められます。

これからTwitter APIの利用を検討している方は、まずは無料プランで基本操作を体験し、自社や個人のニーズに応じてステップアップしていくとよいでしょう。活用の幅が広がれば、情報発信や分析業務の質は飛躍的に高まります。