Twitter検索API
GetXAPIのTwitter/X検索APIは、高度な検索演算子をフルに使ってX検索をクエリし、構造化JSONを1,000ツイートあたり$0.05で返します。投稿者、キーワード、日付範囲、言語、エンゲージメント閾値での絞り込みをリアルタイムに。開発者アカウントもエンドポイント別クォータもありません。
最終更新: 2026年8月16日。数値は同日にXのAPIドキュメントと照合済みです。
Twitter検索APIとは？
Twitter検索APIは、Xの投稿インデックスに対してクエリを実行し、一致したツイートをJSONで返すAPIです。Xの高度な検索と同じ演算子(from:、since:、until:、lang:、min_faves:など)を受け付けるため、投稿者・日付範囲・言語・エンゲージメントによる絞り込みをクライアント側ではなくリクエスト側で行えます。公式版の仕様はXの検索エンドポイントリファレンスに掲載されています。
なぜTwitter検索APIを使うのか
手動の検索ならXのWebアプリで足ります。しかしプロダクト、ダッシュボード、アラート、AIエージェントの中に検索を組み込むなら、エンドポイントとしての検索が必要です。公式X APIにも検索はあり、それが公認のチャネルですが、コストと前提条件が多くのチームには重すぎます:
- 返されたリソース単位の課金。 公式の検索は返されたPost1件ごとに$0.005を課金します。100件ページ1回で$0.50、1,000件で$5です。
- セットアップと月間上限。 開発者アカウントとアプリの設定を済ませた上で、エンドポイント別の時間窓、Recent searchの7日遡及、従量課金の月300万件のPost読み取り上限を前提に設計する必要があります。
- 自作すれば壊れる。 Xの内部を読む無料ライブラリはアカウントやIPの制限を受けやすく、Xの仕様変更で動かなくなることがあります。月額の請求書の代わりに、プロキシの管理と継続的な修正作業を抱えることになります。
GetXAPIはその中間のマネージドな道です。Bearerキー1つ、ドキュメント化された検索エンドポイント1つ、返ってくるのは構造化JSON。1,000ツイート$0.05で、月額の最低額もエンドポイント別クォータもありません。クエリを書けば一致するツイートが返り、下回りのインフラを保守する必要はありません。
検索エンドポイントの使い方
検索は1つのエンドポイントGET /twitter/tweet/advanced_searchに集約されています。qパラメータにクエリを渡し、productでランキングを選び、cursorで結果をページ送りします。1コール$0.001で約20ツイートが返ります。
| パラメータ | 必須 | 説明 |
|---|---|---|
| q | 必須 | 検索クエリ。Xの高度な検索と同じ演算子を受け付けます。例: from:elonmusk min_faves:500 since:2026-01-01 |
| product | 任意 | Latestは新しい順のリアルタイムフィード、Topはエンゲージメントの高い順。省略時はLatest。 |
| cursor | 任意 | 各レスポンスに含まれるページネーショントークン。次のリクエストに渡すと続きのページを取得でき、カーソルが空になるまで繰り返せます。 |
1リクエストでツイートを検索
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.getxapi.com/twitter/tweet/advanced_search?q=from:elonmusk&product=Latest"レスポンスは次ページ用のカーソル付き構造化JSONです。HTMLのパースもプロキシのローテーションも必要ありません。advanced_searchエンドポイントのドキュメント(英語)もご覧ください。
qに渡せる検索演算子
| 演算子 | 一致対象 | 例 |
|---|---|---|
| from:username | 特定アカウントの投稿 | from:elonmusk |
| to:username | 特定アカウント宛ての返信 | to:nasa |
| filter:verified | 認証済みアカウントの投稿のみ | ai agents filter:verified |
| min_faves:N | いいねがN件以上の投稿 | solana min_faves:1000 |
| min_retweets:N | リポストがN件以上の投稿 | launch min_retweets:50 |
| since: / until: | 日付範囲(YYYY-MM-DD) | nvda since:2026-01-01 until:2026-03-01 |
| lang:xx | 特定言語の投稿 | 決算 lang:ja |
| geocode:lat,long,r | 指定地点と半径の近くの投稿 | protest geocode:40.7,-74,10km |
演算子は1つのクエリで組み合わせられます。例: from:elonmusk min_faves:500 since:2026-01-01。演算子の全リストと組み合わせのレシピは高度な検索演算子ガイド(英語)にまとめています。
Latest vs Top: productパラメータ
| product | 返る結果 | 向いている用途 | 鮮度 |
|---|---|---|---|
| Latest | 新しい順(新着が先頭) | リアルタイム監視、アラート、検索データの取り込み | リアルタイム。数秒前の投稿まで |
| Top | エンゲージメント順(高い順) | センチメント集計、ハイライト、ダイジェスト | 直近分。いいねとリポストで重み付け |
パラメータを省略するとLatestになります。クエリに対して最新の投稿ではなく、最もエンゲージメントの高い投稿が欲しいときにTopへ切り替えてください。
GetXAPIの検索 vs 公式X APIとその他の選択肢
| 選択肢 | 価格 | 認証 | レート制限 | リアルタイム性 |
|---|---|---|---|---|
| GetXAPI | 1,000ツイート$0.05 | Bearerトークン、登録30秒 | エンドポイント別クォータなし(全体的なスロットリングあり) | LatestとTop、数秒前まで |
| 公式X APIの検索 | 標準Post読み取り1,000件$5 | X開発者アカウントとアプリ設定 | 従量課金は月300万件のPost読み取り上限 | Recent searchは7日間の遡及 |
| RapidAPIの検索系ラッパー | プロバイダにより異なる | プロバイダごとのRapidAPIキー | プランのクォータ、スロットリングあり | プロバイダにより異なる |
| 無料ライブラリ(twscrape、twikit) | $0 + プロキシと計算資源 | セッションクッキーまたはトークン | アカウント・IP制限のリスク(執行状況は変動) | Xの仕様変更の影響を受けやすい |
料金はフラットでシンプル
$0.05
1,000ツイートの検索あたり
$0.10
登録時の無料クレジット、カード不要
$0
必須のサブスクリプションなし、任意のプランあり
検索コールは1回$0.001で約20ツイートを返すため、1,000ツイートで約$0.05になります。全体の内訳はX API・Twitter APIの料金比較をご覧ください。
検索以上のデータが必要なら
検索は1つのエンドポイントに過ぎません。タイムライン全体、フォロワー、プロフィールも必要なら、同じキーでより広い範囲をカバーするTwitterスクレイパー(英語)をご覧ください。AIエージェントに検索を組み込むならMCPサーバー(英語)が使えます。APIキーの取得はGetXAPIのAPIキーのページで解説しています。
Twitter検索APIのよくある質問
GetXAPIのadvanced_searchエンドポイントは1コール$0.001で、1コールあたり約20ツイートを返します。つまり1,000ツイートの検索が約$0.05です。サブスクリプション必須ではなく、最低利用額もありません。公式X APIはプリペイドの従量課金で、検索結果は返されたリソース単位で課金され、標準のPost読み取りは1件$0.005、1,000件で$5です。登録時に$0.10の無料クレジットが付き、カードは不要です。
X開発者アカウントや公式のOAuthフローは不要です。必要なのはGetXAPIのキーだけで、30秒の登録後にコピーできる単一のBearerトークンです。そのキーがすべての検索リクエストを認証します。登録後1分以内に最初のクエリを実行できます。
検索エンドポイントにエンドポイント固有の日次・15分クォータはありませんが、非常に高い並列度では全体的なスロットリングが適用されます。料金は1コール$0.001の従量制なので、コストはプランの上限ではなく利用量に比例します。定期的な検索の実行や日付範囲のバックフィルを、エンドポイント別の時間窓を気にせず設計できます。
各レスポンスにカーソルトークンが含まれます。次のリクエストのcursorパラメータにそのトークンを渡すと続きのページが取得でき、カーソルが空で返るまで繰り返します。サーバー側で状態を持たずに、クエリや日付範囲の全結果を順に取得できます。
はい。productにLatestを指定すると、数秒前の投稿まで含む新着順のフィードが返ります。ライブ監視やアラートに適した動作です。Topを指定すると、クエリに一致する中でエンゲージメントの高い投稿が返ります。どちらもキャッシュではなくXのライブインデックスに対して実行されます。
使えます。qパラメータはXの高度な検索と同じ演算子を受け付けます: from:、to:、filter:verified、min_faves:、min_retweets:、since:、until:、lang:、geocode:。1つのクエリで組み合わせも可能です。例: from:elonmusk min_faves:500 since:2026-01-01。
productパラメータがランキングを制御します。Latestは一致したツイートを新しい順で返し、リアルタイム監視向きです。Topは同じ一致結果をエンゲージメント順で返し、センチメントのダイジェストやハイライトフィード向きです。パラメータを省略するとLatestになります。
検索APIはクエリ専用のエンドポイントで、演算子を渡すと一致するツイートが返ります。広範なスクレイパーは検索に加えてタイムライン全体、フォロワー、プロフィール、メディアまで取得します。どちらも同じBearerキーと同じ1コール$0.001で動きます。クエリ検索だけならこのエンドポイントが最短で、アカウントの全データが必要なら他のエンドポイントも合わせて使います。