メインコンテンツへスキップ
Search Posts エンドポイントを使用すると、強力なクエリ演算子を使って特定の条件に一致する投稿を検索できます。キーワード、ハッシュタグ、メンション、URL などを対象に検索できます。

​
概要

X では、取得可能な期間とアクセス要件が異なる 2 つの検索エンドポイントを提供しています。

最近の検索

直近 7 日間の投稿を検索できます。すべての開発者が利用できます。

全アーカイブ検索

2006 年まで遡る 完全なアーカイブ を検索できます。従量課金プランおよび Enterprise のお客様が利用できます。

​
ユースケース

  • ブランドモニタリング — 自社ブランドや製品に関する言及をモニタリングする
  • トレンド分析 — 特定のトピックやイベントに関する会話を分析する
  • リサーチ — 学術研究や市場調査向けのデータを収集する
  • リアルタイムリスニング — 新しい投稿に反応するアプリケーションを構築する

​
エンドポイント

MethodEndpointDescriptionAccess
GET/2/tweets/search/recent過去7日間の投稿を検索すべての開発者
GET/2/tweets/search/all全期間の投稿アーカイブを検索従量課金制、Enterprise

​
クエリ演算子

ポストの属性にマッチする演算子を使用してクエリを構築します。 
(AI OR "artificial intelligence") lang:en -is:retweet has:links
OperatorExampleDescription
Keywordpython指定した単語を含む投稿
Phrase"machine learning"完全一致するフレーズを含む投稿
Hashtag#AI指定したハッシュタグを含む投稿
Mention@XDevelopers特定ユーザーへのメンションを含む投稿
OperatorExampleDescription
from:from:elonmusk特定ユーザーによる投稿
to:to:XDevelopers特定ユーザーへの返信
retweets_of:retweets_of:X特定ユーザーの投稿のリツイート
OperatorExampleDescription
lang:lang:en特定の言語の投稿
-is:retweet-is:retweetリツイートを除外した投稿
-is:reply-is:reply返信を除外した投稿
is:verifiedis:verified認証済みユーザーによる投稿

演算子の完全なリファレンス

利用可能なすべての演算子とそのアクセス要件を確認できます
過去7日間の投稿を検索できます。すべての開発者が利用可能です。

​
機能

  • 1リクエストあたり最大100件の投稿
  • 大規模な結果セットに対するページネーション
  • すべての主要なクエリ演算子
  • クエリ長は512文字 (Enterpriseでは4,096文字)

クイックスタート

最初の最近検索リクエストを実行する

APIリファレンス

エンドポイントの詳細なドキュメント
2006年3月までさかのぼるポストの全アーカイブを検索できます。
フルアーカイブ検索は、従量課金制プランおよび Enterprise のお客様にご利用いただけます。

​
機能

  • 1件のリクエストにつき最大500件の投稿
  • 投稿の全履歴にアクセス可能
  • すべてのクエリ演算子を利用可能
  • クエリ長は最大1,024文字 (Enterpriseでは4,096文字)

クイックスタート

最初の全アーカイブ検索リクエストを実行する

APIリファレンス

エンドポイントの全ドキュメント

​
はじめに

前提条件

クエリの作成

クエリ構文と演算子について学ぶ

ページネーション

大規模な結果セットをページングしながら取得する

統合ガイド

主要な概念とベストプラクティス

サンプルコード

実行可能なコード例