keyword | 単体 | コア機能 | Post の本文内のキーワードに一致します。これはトークン化によるマッチングであり、指定したキーワード文字列は Post 本文のトークン化済みテキストと照合されます。トークン化では、句読点、記号、Unicode ベーシックプレーンの区切り文字に基づいて語を分割します。例えば、「I like coca-cola」というテキストを含む Post は、次のトークンに分割されます: I、like、coca、cola。これらのトークンが、クエリで使用したキーワード文字列と比較されます。句読点（例: coca-cola）、記号、または区切り文字を含む文字列にマッチさせるには、キーワードをダブルクォーテーションで囲む必要があります。例:pepsi OR cola OR "coca cola" |
絵文字 | 単体 | コア | Post 本文内の絵文字に一致します。キーワードと同様に、絵文字はトークン化による一致であり、指定した絵文字は Post 本文のトークン化済みテキストと照合されます。絵文字にバリアントがある場合は、クエリに追加する際に必ず二重引用符で囲んでください。例:(😃 OR 😡) 😬 |
"フレーズの完全一致" | 単体 | コア | Postの本文内で、指定したフレーズに完全一致でマッチします。例：("X API" OR #v2) -"recent counts" |
# | 単体 | コア機能 | 認識済みのハッシュタグを含む任意のPostにマッチします（そのハッシュタグがPost内で認識済みエンティティである場合）。このオペレーターはトークン化によるマッチではなく、完全一致で動作します。つまり、このルール#thankuは、ハッシュタグ #thanku に完全一致する投稿のみを対象とし、ハッシュタグ #thankunext の投稿には一致しません。例：#thankunext #fanart OR @arianagrande |
@ | 単体 | コア | 指定したユーザー名が認識済みのエンティティである場合（@文字を含む）、そのユーザー名への言及を含む任意のPostに一致します。例:(@XDevelopers OR @API) -@X |
$ | 単体 | 詳細設定 | 先頭文字が「」のトークンである指定の「キャッシュタグ」を含む任意のPostに一致します。なお、キャッシュタグ演算子はXのsymbolsエンティティ抽出に依存しています'本文からキャッシュタグを直接抽出しようとするのではなく、X の「symbols」エンティティ抽出を用いてキャッシュタグを一致させてください。例：`twtr OR @XDevelopers -$fb` |
from: | 単体 | コア機能 | 特定のユーザーの任意のPostに一致します。値には、ユーザー名（@は含めない）または数値のユーザーIDのいずれかを指定できます。from: 演算子ごとに指定できるユーザー名/IDは1つだけですfrom:演算子。例：from:XDevelopers OR from:API -from:X |
宛先: | 単体 | コア | 特定のユーザーへの返信である任意のPostに一致します。値には、ユーザー名（@文字を除く）またはユーザーの数値のユーザーIDのいずれかを指定できます。指定できるユーザー名/IDは1つのみです宛先:演算子。例:to:XDevelopers OR to:API -to:X |
url: | 単体 | コア機能 | Post の有効な形式の URL に対してトークン化マッチを実行します。このオペレーターは url フィールドと expanded_url フィールドの両方の内容にマッチできますurlまたはexpanded_urlfields。たとえば、Post に”X Developer Labs をぜひご覧ください：https://t.co/c0A36SWil4”（短縮URLが次にリダイレクトされる場合）https://developer.x.com) は次の2つのルールの両方に一致します：from:XDevelopers url:"https://developer.x.com"およびfrom:XDevelopers url:"https://t.co". 句読点や特殊文字を含むトークンやフレーズは、ダブルクォーテーションで囲んでください。 |
retweets_of: | 単体 | コア機能 | 指定したユーザーのリツイートであるPostに一致します。値には、ユーザー名（@ 文字を除く）またはそのユーザーの数値のユーザーIDのいずれかを指定できます。指定できるユーザー名/IDは1つのみですretweets_of:演算子。例：retweets_of:XDevelopers OR retweets_of:API |
context: | 単体 | コア | 特定のドメインid/エンティティidのペアに一致するPostを取得します。1つのドメイン/エンティティのみを指定できますcontext:演算子。例：context:domain_id.entity_id。OR 演算子を使って複数のドメインやエンティティを組み合わせることができます：(context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | 単体 | コア機能 | 特定のエンティティの文字列値に一致するPostを返します。指定できるのは1つのentity:演算子。例：entity:"エンティティ／場所の文字列表現"。これは最新の検索でのみご利用いただけますのでご注意ください。 |
conversation_id: | 単体 | コア機能 | 共通の会話IDを持つPostにマッチします。会話IDは、会話を開始したPostのPost IDに設定されます。Postへの返信が投稿されると、返信への返信であっても、conversation_idはそのJSONペイロードに追加されます。conversation_id:オペレーターごとに渡せる会話IDは1つだけですconversation_id:演算子。例：conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | 単体 | 詳細設定 | 指定したリストのメンバーであるユーザーが投稿したPostに一致します。たとえば、@XDevelopers と @API がリスト 123 のメンバーで、あなたがlist:123クエリに含めると、レスポンスにはそれらのアカウントが公開したPostのみが含まれます。ListのIDは、List lookupエンドポイントを使用して取得できます。例：list:123 |
place: | 単体 | 詳細設定 | 指定した場所またはXのplace IDでタグ付けされたPostにマッチします。複数語の地名（「New York City」「Palo Alto」）は引用符で囲んでください。1回のplace:演算子につき指定できる場所は1つだけですplace:operator。注: X の place ID を取得する方法は、GET geo/search standard v1.1 エンドポイントを参照してください。例:place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | 単体 | 詳細 | タグ付けされた場所/ロケーションに紐づく国コードが、指定した ISO アルファ2文字コードと一致する Post にマッチします。有効な ISO コードの一覧は Wikipedia で確認できます。place_country: 演算子で指定できる ISO コードは1つだけですplace_country:演算子。例：place_country:US OR place_country:MX OR place_country:CA |
point_radius: | 単体 | 詳細設定 | 〜に一致しますplace.geo.coordinates存在する場合は Post の place.geo.coordinates オブジェクトに対して、また X では、定義済みの領域内に Place ポリゴンが完全に含まれている場所ジオポリゴンに対して照合します。point_radius:[longitude latitude radius]. 半径の単位はマイル（mi）とキロメートル（km）に対応しています。半径は25mi未満でなければなりません。経度は±180の範囲、緯度は±90の範囲です。すべての座標は小数度です。ルールの引数は角括弧で囲み、空白で区切ります。例:point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | 単体 | 詳細設定 | 存在する場合は Post の place.geo.coordinates オブジェクトに対してマッチし、X では、定義された領域内にプレースのポリゴンが完全に含まれている場合、そのプレースのジオポリゴンに対してマッチします。bounding_box:[west_long south_lat east_long north_lat]. バウンディングボックスの幅と高さは25mi未満である必要があります。経度は±180の範囲、緯度は±90の範囲です。すべての座標は小数度で指定します。ルール引数は角括弧内にスペース区切りで記述します。例:bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | 接続詞が必要です | コア機能 | 指定したルールの他の条件にも一致するRetweetにマッチします。このオペレーターは、いわゆる「本物の」Retweet（たとえばRetweetボタンで作成されたもの）のみを対象とします。Quote Tweetにはマッチしません。例：data @XDevelopers -is:retweet |
is:reply | 接続詞が必要です | コア | ルールに一致する明確な返信のみを配信します。否定形を用いることで、クエリに一致する返信を配信対象から除外することもできます。注: このオペレーターは filtered stream エンドポイントでも利用可能です。filtered stream と併用した場合、このオペレーターは元の Post への返信、引用された Post 内の返信、Retweet 内の返信にマッチします。例:from:XDevelopers is:reply |
is:quote | 接続詞が必要です | コア | コメント付きのPost（Quote Tweetとも呼ばれます）をすべて返します。例:"センチメント分析" is:quote |
is:verified | 接続詞が必要です | コア機能 | X によって認証済みの投稿者が作成した Post のみを配信します。例：#nowplaying is:verified |
-is:nullcast | 接続詞が必要です | 詳細設定 | ads.x.com でのプロモーションのみを目的として作成された Post を削除します。該当の Post には"source":"Twitter for Advertisers（旧）"または"source":"Twitter for Advertisers"。このオペレーターは必ず否定して使用してください。Nullcast された Post の詳細は、Post の可用性に関するページをご覧ください。例:"mobile games" -is:nullcast |
has:hashtags | 接続詞が必要です | コア機能 | 少なくとも1つのハッシュタグを含むPostにマッチします。例：from:XDevelopers -has:hashtags |
has:cashtags | 接続詞が必要です | 詳細設定 | 先頭に「」が付くキャッシュタグを含むPostにマッチします。例：‘tag）。例:#stonks has:cashtags` |
has:links | 接続詞が必要です | コア機能 | このオペレーターは、Post本文にリンクとメディアを含むPostにマッチします。例：from:XDevelopers announcement has:links |
has:mentions | 接続詞が必要です | コア機能 | 他のXユーザーへの言及を含むPostにマッチします。例：#nowplaying has:mentions |
has:media | 接続詞が必要です | コア機能 | X が判定した、写真・GIF・動画などのメディアオブジェクトを含む Post に一致します。Periscope で作成されたメディアや、他のメディアホスティングサイトへのリンクを含む Post には一致しません。例:(kittens OR puppies) has:media |
has:images | 接続詞が必要です | コア | 画像への既知のURLを含むPostに一致します。例：#meme has:images |
has:videos | 接続詞が必要です | コア機能 | X に直接アップロードされた、X のネイティブ動画を含む Post にマッチします。Periscope で作成された動画や、他の動画ホスティングサイトへのリンクを含む Post にはマッチしません。例:#icebucketchallenge has:videos |
has:geo | 接続詞が必要です | 詳細 | Xユーザーが提供した、Post固有の位置情報データを持つPostに一致します。位置情報は、対応する表示名・ジオポリゴン・その他のfieldsを含むXのplaceとして指定される場合、または稀に緯度・経度の座標として指定される場合があります。注: place（Postのジオ）でのマッチングを行うオペレーターは、オリジナルの投稿のみを対象とします。Retweetにはplaceデータは含まれません。例:recommend #paris has:geo -bakery |
lang: | 接続詞が必要です | コア機能 | X によって特定の言語であると分類された Post に一致します（その Post が分類されている場合に限ります）。各 Post は現在、1 つの言語にのみ分類されるため、複数の言語を AND で組み合わせても結果は得られない点に注意してください。指定できる BCP 47 言語識別子は 1 つのみですlang:operator. 注意: 言語を判定できない場合、返される結果は「und」（未定義）になります。例:recommend #paris lang:en |
