Skip to main content
/search-tweetsは、X(Twitter)の公開検索インデックスに対してキーワードや演算子を使った検索を実行し、一致するツイートを投稿者の完全なプロフィールとエンゲージメント指標付きで返します。 一連の実装パターン、検索条件のテンプレート、実行可能なコードは、ブログのAPIでツイートを検索する方法を参照してください。

エンドポイント

認証

ApiKeyヘッダーでAPIキーを渡します。HTTPヘッダー名の大文字・小文字は区別されませんが、キーの値は発行されたものと一致する必要があります。
詳しくは認証を参照してください。

リクエスト本文

リクエストの例

レスポンス

各ツイートには投稿者の完全なプロフィールが含まれます。ユーザー情報を付けるために別のリクエストを送る必要はありません。
全フィールドの説明はレスポンス形式を参照してください。

検索演算子

queryには、次のようなXのネイティブ検索演算子をすべて指定できます。
  • キーワードと完全一致フレーズ: "climate change"
  • ユーザーフィルター: from:to:@mention
  • エンゲージメントフィルター: min_faves:min_retweets:min_replies:
  • 内容のフィルター: filter:mediafilter:imagesfilter:videosfilter:links(先頭に-を付けると除外)
  • 言語と日付: lang:ensince:2026-01-01until:2026-03-01
  • 論理演算: OR、グループ化の丸括弧、除外の-
全演算子のリファレンス:検索演算子

ページネーション

レスポンスにはnext_cursorが含まれます。次のページを取得するには、同じリクエストにその値をnext_cursorとして指定します。next_cursornullまたは存在しなければ、すべての結果を取得済みです。
カーソルを使った実装パターンと例外的なケースは、ページネーションを参照してください。

レート制限

すべてのプランで、APIキーごとに毎秒20リクエストです。超過すると429 Too Many Requestsが返されます。レート制限を参照してください。

エラーコード

全一覧はエラーコードを参照してください。

関連エンドポイント