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