queryとx.comで利用できます。一部の「画面限定」の演算子は、ログイン中のアカウント（フォロー先、現在地、ネットワーク）に依存するため、APIでは使えません。
注： コピーして使える検索条件、実運用向けのコード例（ページネーション付きPython・JavaScript）、公式X API v2の演算子との比較は、ブログのTwitter検索演算子の完全早見表を参照してください。
構文の基本
- 語の間の空白は暗黙のANDです
ORは大文字で記述します- 先頭のハイフン（
-）で語、フレーズ、演算子を除外します - 丸括弧で式をグループ化します
- 完全一致のフレーズを二重引用符で囲みます
cat OR black dogはcat OR (black dog)として解釈されます。丸括弧で曖昧さをなくしてください。
無料のビジュアル検索ビルダー
演算子を手作業で組み立てたくない場合は、Sorsa Search Builderを使ってください。ログイン不要の無料ツールで、画面上でフィルターを切り替え、生成された検索文字列を確認してからコードに組み込めます。1. キーワードと論理演算
複数形は単数形にも一致し、その逆も同様です。演算子はツイート本文、投稿者の表示名、ユーザー名、ツイート内の展開されたURLを対象にします。
2. ユーザーとアカウントのフィルター
3. エンゲージメントによる絞り込み
非常に大きい値（1,000以上）では、件数は概算になります。
4. メディアと内容の種類
メディアフィルター
ツイートの種類のフィルター
特殊な内容のフィルター
5. 日付、時刻、Snowflake ID
Snowflake IDの変換。 各ツイートIDには作成日時が符号化されています。
6. 地理的なフィルター
正確な位置情報を持つツイートは推定1〜2%です。ツイートに座標がない場合、APIはユーザーのプロフィール上の場所から逆ジオコーディングを行います。
7. 言語と投稿元
言語
標準のISO 639-1コード（lang:en、lang:es、lang:fr、lang:de、lang:ja、lang:ruなど）と、次のX独自のコードが使えます。
投稿元（クライアント）
一般的な値：
Twitter_for_iPhone、Twitter_for_Android、Twitter_Web_App、TweetDeck、twitter_ads。
8. CardとURLの演算子
card_name:は通常、過去7〜8日間のツイートにのみ一致します。
検索条件の組み立て方
複雑な条件にも対応しやすい、実用的な順序です。- 中心となるキーワードをグループ化：
(bitcoin OR ethereum OR $BTC) - 内容の条件を追加：
lang:en、filter:images、-filter:replies - エンゲージメントのしきい値を設定：
min_faves:50、min_retweets:10 - ノイズを除外：
-from:spambot、-scam、-filter:retweets - 期間を指定：
since:2026-01-01 until:2026-03-01
既知の制限
- 演算子数の上限： 1つの検索条件につき約22〜23個です。
- 位置情報のカバー率が低い： 正確な位置情報を持つツイートは1〜2%だけです。
card_name:の期間制限： 過去7〜8日間が対象です。- 非公開・凍結アカウントは検索結果から除外されます。
- 言語判定は完全ではありません。 短いツイート、コード、絵文字の多い投稿では特に注意してください。
- すべてのツイートが検索対象とは限りません。 プラットフォームの違反フラグが付いた投稿は除外される場合があります。
- 自動修正が通知なしに行われることがあります。完全一致を強制するには
+wordまたは"word"を使ってください。 - URLの一致はドメイン・サブドメインには有効ですが、長いURLパスでは安定しません。
出典
このリファレンスは、Igor Brigadir氏が継続的に更新しているtwitter-advanced-searchリポジトリを参考にしています。これは、文書化されていないXの検索挙動について広く使われている情報源です。次のステップ
- ツイート検索：
/search-tweetsの完全ガイド。 - メンションの追跡：任意のアカウントへの@メンションを追跡する方法。
- ページネーション：大量の検索結果を順に取得する。
- Search Builder：無料のビジュアル検索ビルダー。
- ブログの完全早見表：検索条件、コード例、X API v2との比較。