| ”完全一致のフレーズ” | PowerTrack
Search | ポスト本文中のフレーズに完全一致するものにマッチします。
検索オペレーターに変換可能なコンポーネントは、単語として扱われます。言い換えると、次のとおりです。
* "#hashtag" は hashtag にはマッチしますが、#hashtag にはマッチしません (実際のハッシュタグにマッチさせるには、引用符を付けずに hashtag operator を使用してください) * "$TWTR" は単語 TWTR にはマッチしますが、キャッシュタグ $TWTR にはマッチしません (実際のキャッシュタグにマッチさせるには、引用符を付けずに cashtag operator を使用してください)
注: 30 Day Search および Full Archive Search (Enterprise と Premium) では、句読点はトークナイズされず、空白文字として扱われます。 | text |
| @ | PowerTrack
Search | 指定したユーザー名がメンションされているポストにマッチします。値には、ユーザー名 (@ 文字を含めない形式) またはユーザーの数値 id (たとえば GET users/lookup エンドポイントで取得したもの) を指定できます。 | entities.user_mentions |
| # | PowerTrack
Search | 指定したハッシュタグを含むポストすべてにマッチします。
このオペレーターは完全一致で照合を行います。たとえば、ルール #1989 は、ハッシュタグ #1989 をそのまま含む投稿にはマッチしますが、ハッシュタグ #TaylorSwift1989 を含む投稿にはマッチしません。
注記: このオペレーターは、本文からハッシュタグ自体を抽出するのではなく、X のエンティティ抽出機能に依存してハッシュタグをマッチさせます。エンティティ由来の JSON 属性の詳細については、X Entities を参照してください。 | entities.hashtags |
| $ | PowerTrack
Search | 指定したキャッシュタグ (先頭文字が $ のトークン) を含む任意のポストにマッチします。
注: このオペレーターは、本文からリンクを抽出するのではなく、X のエンティティ抽出に依存してリンクをマッチングします。エンティティに由来する JSON 属性の詳細については、X Entities を参照してください。 | entities.symbols |
| bio: | PowerTrack | 利用可能なエイリアス: user_bio:
投稿したユーザーの自己紹介文内のキーワード (トークン化マッチを使用) またはフレーズにマッチします。フレーズにマッチさせるには二重引用符を使用します。つまり:
* bio:software engineer は、自己紹介文に software という単語を含むユーザーが行った投稿のうち、キーワード engineer を含むものにマッチします * bio:"software engineer" は、自己紹介文に software engineer というフレーズを含むユーザーが投稿した任意の投稿にマッチします | user``.description |
| bio_location: | PowerTrack | 利用可能な別名: user_bio_location:
User object の location に指定したキーワード (トークン化マッチを使用) またはフレーズが含まれている投稿にマッチします。
この location は正規化されていない、ユーザーが自由に入力したフリーフォーム文字列であり、ポストの location (存在する場合) とは異なります。 | user.location |
| bio_name: | PowerTrack | User object の name に指定したキーワード (トークン化マッチを使用) またはフレーズが含まれている投稿にマッチします。 | user.name |
| bounding_box: | PowerTrack
Search | 利用可能なエイリアス: geo_bounding_box:
投稿の正確な位置情報 (経度 long、緯度 lat。存在する場合) およびジオポリゴン (Place が定義された領域内に完全に含まれている場合) に対してマッチします。
* west_long south_lat はバウンディングボックスの南西端を表し、west_long がその点の経度、south_lat が緯度です。 * east_long と north_lat はバウンディングボックスの北東端を表し、east_long がその点の経度、north_lat が緯度です。 * バウンディングボックスの幅と高さは 25 マイル未満である必要があります。 * 経度は ±180 の範囲内です。 * 緯度は ±90 の範囲内です。 * すべての座標は度 (小数点表記) です。 * ルール引数は角括弧内に記述し、スペース区切りにします。
注: place (投稿のジオ情報) にマッチする演算子は、オリジナルの投稿のみを対象とします。リツイートには place データは含まれません。 | place (元の投稿のみ) |
| contains: | PowerTrack | トークン化の有無に関係なく、本文中に指定した部分文字列を含む投稿に対して部分文字列一致を行います。つまり、単純な部分文字列一致を行い、単語境界は考慮しません。
空白や句読点を含む部分文字列に一致させるには、その文字列を二重引用符 (”) で囲んでください。 | text |
| <emoji> | PowerTrack
Search | ポスト本文内の絵文字に一致します。
これはトークン単位でのマッチであり、指定した絵文字はポスト本文のトークン化されたテキストと照合されます。トークン化は、句読点、記号/絵文字、および区切り記号として扱われる Unicode 基本多言語面の文字に基づいて行われます。たとえば、「I like 🍕」というテキストのポストは、I、like、🍕 というトークンに分割されます。これらのトークンが、ルールで使用した絵文字と比較されます。
Note: 絵文字にバリアントがある場合は、その絵文字をルールに追加する際にダブルクォーテーションで囲む必要があります。 | text |
| followers_count: | PowerTrack | 著者のフォロワー数が指定した範囲内にある投稿に一致します。
* 単一の数値 (例: followers_count:42) は、指定した値以上の任意の数値に一致します。 * 範囲 (例: followers_count:42..1337) は、指定した範囲内の任意の数値に一致します。 | user.followers_count |
| friends_count: | PowerTrack | 利用可能なエイリアス: following_count:
著者の friends_count (フォローしているユーザー数) が指定した範囲内にある投稿にマッチします。
* 単一の数値 (例: followers_count:42) は、指定した値以上の任意の数値にマッチします。 * 範囲 (例: followers_count:42..1337) は、指定した範囲内の任意の数値にマッチします。 | user.friends_count |
| from: | PowerTrack
Search | 特定ユーザーからの任意のポストにマッチします。値として指定できるのは、ユーザー名 (@ 文字を除く) か、そのユーザーの数値 ID です。数値 ID は、たとえば GET users/lookup エンドポイントで取得できます。 | user.id, user.id_str (ユーザーIDを使用する場合)
user.screen_name (ユーザー名を使用する場合) |
| has:geo | PowerTrack
Search | X によって投稿固有の位置情報データが付与されている投稿にマッチします。これは「geo」による緯度・経度の座標、または X の Place としての「location」 (対応する表示名、ジオポリゴン、その他のフィールドを含む) のいずれかです。
単独のオペレーターとしては使用できません。
注: place (投稿の位置情報) にマッチするオペレーターは、元の投稿のみを対象とします。リツイートには place データは含まれません。 | place (元のツイートのみ) |
| has:hashtags | PowerTrack
Search | 少なくとも 1 つのハッシュタグを含む投稿にマッチします。
単独のオペレーターとしては使用できません。 | entities.hashtags |
| has:images | PowerTrack
Search | 少なくとも1つの分類済みの画像URLを含む投稿にマッチします。
単独のオペレーターとしては使用できません。 | entities.media |
| has:lang | PowerTrack | X によって特定の言語に分類された投稿にマッチします。
ポストが分類されていない場合、この演算子はマッチしません。各ポストは現在 1 つの言語にのみ分類されているため、複数の言語を AND で組み合わせても結果は返されません。
単独の演算子としては使用できません。 | lang (値が und でない場合) |
| has:links | PowerTrack
Search | このオペレーターは、ポスト本文内にリンクを含む投稿にマッチします。
単独のオペレーターとしては使用できません。
注: このオペレーターは、本文から直接リンクを抽出するのではなく、リンクをマッチさせるために X のエンティティ抽出機能に依存します。エンティティ由来の JSON 属性の詳細については、X Entities を参照してください。 | entities.urls |
| has:media | PowerTrack
Search | 利用可能なエイリアス: has:media_link
少なくとも 1 つの分類されたメディア URL を含む投稿に一致します。
単独のオペレーターとしては使用できません。 | entities.media |
| has:mentions | PowerTrack
Search | 他のXユーザーに言及している投稿にマッチします。
単独のオペレーターとしては使用できません。 | entities.user_mentions |
| has:profile_geo | PowerTrack
Search | 利用可能なエイリアス: has:derived_user_geo
実際の値に関係なく、任意の Profile Geo メタデータが付与されている投稿にマッチします。
単独のオペレーターとしては使用できません。 | user.location |
| has:symbols | PowerTrack
Enterprise | キャッシュタグ (例: $TWTR) を含む投稿にマッチします。
単独のオペレーターとしては使用できません。 | entities.symbols |
| has:videos | PowerTrack
Search | 利用可能なエイリアス: has:video_link
少なくとも 1 つの分類済みメディア URL を含む投稿に一致します。
単独の演算子としては使用できません。 | entities.media |
| in_reply_to_status_id: | PowerTrack | 利用可能なエイリアス: in_reply_to_tweet_id:
指定したポストへの明示的な返信だけを配信します。 | 対象ポストの id/id_str フィールド |
| is:quote | PowerTrack | ルールに一致する明示的な引用ツイートのみを配信します。
また、否定形 (-is:quote) を使用すると、ルールに一致する引用ツイートを配信から除外できます。
このオペレーターは単独では使用できません。 | is_quote_status が true の場合 |
| is:reply | PowerTrack
Search | ルールに合致する返信のみを配信します。
-is:reply を指定して否定することで、指定したルールに合致する返信を配信から除外することもできます。
PowerTrack では、このオペレーターは次の対象にマッチします。
* 元のポストへの返信 * 引用された投稿内の返信 * リツイート内の返信
Search API で使用する場合、このオペレーターは元のポストへの返信にはマッチしますが、引用ツイート内の返信およびリツイート内の返信は除外されます。
このオペレーターは is:retweet および is:quote と組み合わせて使用することで、元のポストへの返信のみを配信できます。
Search API では単独のオペレーターとしては使用できません。
注意: Premium では、このオペレーターは Sandbox 開発環境では利用できません。 | 返信要素 (例: in_reply_to_status_id) |
| is:retweet | PowerTrack
Search | ルールに一致する明示的なリツイートのみを配信します。
また、否定形 (-is:retweet) を使用して、ルールに一致するリツイートを配信から除外し、オリジナルのコンテンツのみを配信することもできます。
この演算子は、リツイートボタンを使用して投稿された正規のリツイートのみを検出します。X のリツイート機能を使用しない引用ツイートや内容が変更された投稿は、この演算子では一致しません。
単独の演算子としては使用できません。 | リツイート要素 (例:retweeted_status) |
| is:verified | PowerTrack
Search | 投稿者がXにより認証済みの投稿のみを配信します。
また、否定形を用いることで、投稿者が認証済みの投稿を除外できます。
単独のオペレーターとしては使用できません。 | user.verified |
| keyword | PowerTrack
Search | ポスト本文内のキーワードにマッチします。
これはトークン単位でのマッチであり、指定したキーワード文字列はポスト本文のトークン化されたテキストと照合されます。トークン化は、句読点、記号/絵文字、およびセパレーターに該当する Unicode 基本多言語面の文字に基づいて行われます。たとえば、「I like coca-cola」というテキストのポストは、次のトークンに分割されます: I, like, coca, cola。これらのトークンが、ルールで使用したキーワード文字列と比較されます。句読点 (例: coca-cola) 、記号、またはセパレーター文字を含む文字列にマッチさせるには、exact phrase match 演算子を使用する必要があります。 | text |
| lang: | PowerTrack
Search | X によって特定の言語に分類された投稿 (投稿が分類されている場合にのみ) にマッチします。各投稿は 1 つの言語にのみ分類されるため、複数の言語を AND で組み合わせても結果は得られません。
注: 言語分類が行えない場合、返される値は und (未定義) です。
このオペレーターは、サポートされている言語に対してのみマッチします。und を含むそれ以外の値を指定した場合、このオペレーターは無視されます (つまり、投稿はこのオペレーターではフィルタリングされません) 。以下のリストは、現在サポートされている言語と、それに対応する BCP 47 言語識別子を示します。
am Amharic (アムハラ語)
hu Hungarian (ハンガリー語)
pt Portuguese (ポルトガル語)
ar Arabic (アラビア語)
is Icelandic (アイスランド語)
ro Romanian (ルーマニア語)
hy Armenian (アルメニア語)
in Indonesian (インドネシア語)
ru Russian (ロシア語)
bn Bengali (ベンガル語)
it Italian (イタリア語)
sr Serbian (セルビア語)
bg Bulgarian (ブルガリア語)
ja Japanese (日本語)
sd Sindhi (シンド語)
my Burmese (ビルマ語)
kn Kannada (カンナダ語)
si Sinhala (シンハラ語)
zh Chinese (中国語)
km Khmer (クメール語)
sk Slovak (スロバキア語)
cs Czech (チェコ語)
ko Korean (韓国語)
sl Slovenian (スロベニア語)
da Danish (デンマーク語)
lo Lao (ラオス語)
ckb Sorani Kurdish (ソラニー・クルド語)
nl Dutch (オランダ語)
lv Latvian (ラトビア語)
es Spanish (スペイン語)
en English (英語)
lt Lithuanian (リトアニア語)
sv Swedish (スウェーデン語)
et Estonian (エストニア語)
ml Malayalam (マラヤーラム語)
tl Tagalog (タガログ語)
fi Finnish (フィンランド語)
dv Maldivian (ディベヒ語)
ta Tamil (タミル語)
fr French (フランス語)
mr Marathi (マラーティー語)
te Telugu (テルグ語)
ka Georgian (グルジア語)
ne Nepali (ネパール語)
th Thai (タイ語)
de German (ドイツ語)
no Norwegian (ノルウェー語)
bo Tibetan (チベット語)
el Greek (ギリシャ語)
or Oriya (オリヤー語)
tr Turkish (トルコ語)
gu Gujarati (グジャラート語)
pa Panjabi (パンジャブ語)
uk Ukrainian (ウクライナ語)
ht Haitian (ハイチ語)
ps Pashto (パシュトー語)
ur Urdu (ウルドゥー語)
iw Hebrew (ヘブライ語)
fa Persian (ペルシア語)
ug Uyghur (ウイグル語)
hi Hindi (ヒンディー語)
pl Polish (ポーランド語)
vi Vietnamese (ベトナム語)
cy Welsh (ウェールズ語) | lang (値が und 以外の場合) |
| listed_count: | PowerTrack | 利用可能なエイリアス: user_in_lists_count:
投稿の作者がX上のリストに追加された回数が、指定した範囲内にある場合に、その投稿にマッチします。
* 単一の数値 (例: listed_count:42) は、指定した値以上の任意の数値にマッチします。 * 範囲 (例: listed_count:42..1337) は、指定した範囲内の任意の数値にマッチします。 | user.listed_count |
| place_country: | PowerTrack
Search | タグ付けされた 場所/ロケーション に関連付けられている国コードが、指定された ISO アルファベット 2 文字コード と一致する投稿にマッチします。
注: place (Post geo) でマッチングを行うオペレーターは、オリジナルの投稿のみを対象とします。リツイートには place データが含まれません。 | place (オリジナルのポストのみ) |
| place: | PowerTrack
Search | 指定した場所または X place ID がタグ付けされた投稿に一致します。複数語から成る場所名は引用符で囲む必要があります (例: place:"San Francisco")
Note: place (Post geo) に基づいてマッチングを行うオペレーターは、オリジナルの投稿のみを対象とします。リツイートには place データが含まれていません。 | place (オリジナルの投稿のみ) |
| point_radius: | PowerTrack
Search | 注: place (ポストの位置情報) にマッチするオペレーターは、オリジナルの投稿のみを対象とします。リツイートには place データが含まれません。 | place (オリジナルの投稿のみ) |
| profile_bounding_box:[west_long south_lat east_long north_lat] | PowerTrack | 定義された領域内に Place が完全に含まれている場合、Profile Geo enrichment におけるユーザーの正確な Location (経度 long、緯度 lat) にマッチします。
* west_long と south_lat はバウンディングボックスの南西端を表し、west_long がその地点の経度、south_lat が緯度です。 * east_long と north_lat はバウンディングボックスの北東端を表し、east_long がその地点の経度、north_lat が緯度です。 * バウンディングボックスの幅と高さは 25mi (約 25 マイル) 未満である必要があります * 経度は ±180 の範囲内です * 緯度は ±90 の範囲内です * すべての座標は 10 進度で指定します。 * ルール引数は角括弧内に含め、スペース区切りで指定します。
Note: place (ポストの位置情報) に対してマッチングするオペレーターは、元の投稿に対するマッチのみを対象とします。リツイートには place データが含まれていません。 | user.derived.locations.geo.coordinates |
| profile_country: | PowerTrack
Search | Profile Geo enrichment の国コードに対する完全一致です。
ISO-3166-1-alpha-2 specification に基づいた、正規化された2文字の国コードのセットを使用します。
仕様を簡潔に保つため、住所オブジェクトの country フィールド用オペレーターの代わりとして、このオペレーターが提供されています。
注意: place (ポストのジオ情報) に対してマッチするオペレーターは、元のポストからのマッチのみを含みます。リツイートには place データが含まれていません。 | user.derived.locations.country_code |
| profile_locality: | PowerTrack
Search | Profile Geo enrichment の Locality フィールドの値に対して厳密に一致します。
文字列全体が完全に一致している必要があります。
バックスラッシュで文字をエスケープする必要はありません。たとえばスラッシュを含むものにマッチさせる場合は、one/two を使用します。
空白や句読点を含む部分文字列にマッチさせるには二重引用符を使用してください。例: profile_locality:"Lower East Side"。 | user.derived.locations.locality |
| profile_point_radius:[lon lat radius] | PowerTrack | ユーザーの Profile Geo enrichment における Exact Location (x,y) に対して照合を行います。
* 半径に指定できる単位はマイル (mi) とキロメートル (km) です。 * 半径は 25mi 未満である必要があります。 * 経度は ±180 の範囲です。 * 緯度は ±90 の範囲です。 * すべての座標は度を表す 10 進数です。 * ルール引数は角括弧内に記述し、スペース区切りで指定します。
Note: place (ポストの位置情報) にマッチするオペレーターは、オリジナルのポストのみを対象にマッチします。リツイートには place データが含まれません。 | user.derived.locations.geo |
| profile_region: | PowerTrack
Search | Profile Geo enrichment の Region フィールドの値に対する完全一致。
これは文字列全体が完全に一致する必要があるマッチです。
バックスラッシュで文字をエスケープする必要はありません。たとえば、スラッシュを含むものにマッチさせる場合は one/two のように指定します。
空白や句読点を含む部分文字列にマッチさせるには、profile_locality:"New York" のように二重引用符を使用してください。 | user.derived.locations.region |
| profile_subregion: | PowerTrack | Profile Geo enrichment の Subregion フィールドとの完全一致です。
これは文字列全体に対する完全一致です。
バックスラッシュで文字をエスケープする必要はありません。たとえばスラッシュを含むものにマッチさせる場合は、one/two を使用します。
空白や句読点を含む部分文字列に一致させるには二重引用符を使用します。例: profile_locality:"Kings County"。 | user.derived.locations.sub_region |
| ”keyword1 keyword2”~N | PowerTrack
Search | 一般的に「近接演算子」と呼ばれ、キーワード同士が互いに N トークン以内の距離にあるポストにマッチします。
キーワードの順序が逆の場合は、互いの距離が N-2 トークン以内でなければなりません。
引用符内には任意の数のキーワードを指定できます。
N は 6 を超えることはできません。 | text |
| retweets_of_status_id: | PowerTrack | 利用可能なエイリアス: retweets_of_tweet_id:
指定した元のポストの明示的なリツイートのみを返します。 | retweeted_status.id, retweeted_status.id_str |
| retweets_of: | PowerTrack
Search | 利用可能な別名: retweets_of_user:
指定したユーザーのポストをリツイートした任意のポストにマッチします。値には、ユーザー名 (@ 文字を含めない) またはユーザーの数値 ID (たとえば GET users/lookup エンドポイント経由で取得したもの) を指定できます。 | retweeted_status.id (存在する場合) |
| sample: | PowerTrack | ルールに一致する投稿全体ではなく、そのランダムに抽出されたパーセントサンプルを返します。パーセント値は 1 から 100 までの整数で指定する必要があります。
このオペレーターはルール全体に適用され、OR で結合されたすべての項目をグループ化する必要があります。
注: sample オペレーターは、まず firehose の範囲を X% に絞り込み、その後にルール/フィルターがそのサンプル対象のサブセットに適用されます。たとえば sample:10 を使用する場合、各投稿がサンプルに含まれる確率は 10% です。
注: サンプリングは決定論的に行われるため、履歴データを取得した場合と同じデータサンプルをリアルタイムでも取得できます。 | |
| source: | PowerTrack | 指定されたソースアプリケーションによって生成されたポストすべてにマッチします。値にはアプリケーション名またはアプリケーションのURLのいずれかを指定する必要があります。
単独のオペレーターとしては使用できません。 | source |
| statuses_count: | PowerTrack | 利用可能な別名: tweets_count:
投稿者が投稿したステータス数が指定した範囲内にある投稿にマッチします。
* 単一の数値 (例: statuses_count:42) は、指定した値以上の任意の値にマッチします。 * 範囲 (例: statuses_count:42..1337) は、指定した範囲内の任意の値にマッチします。 | user``.statuses_count |
| to: | PowerTrack
Search | 特定のユーザーへの返信であるポストにマッチします。値には、ユーザー名 (@ 文字を除く) または、そのユーザーの数値 ID (たとえば GET users/lookup エンドポイントで取得可能) を指定できます。 | text |
| url: | PowerTrack
Search | ポストの展開済みURLに対してトークン単位のマッチングを行います。句読点や特殊文字を含むトークンやフレーズは二重引用符で囲む必要があります (例: url:"/developer") 。
一般的には推奨されませんが、この演算子は特定のプロトコルを対象としてマッチさせることもでき、その場合は二重引用符で囲みます (例: url:"https://developer.x.com") 。 | entities.urls.expanded_url |
| url_contains: | PowerTrack | 新しい拡張URLタイトルのメタデータエンリッチメントに対してキーワード/フレーズの一致を実行します。 | entities.urls.expanded_url |
| url_description: | PowerTrack | 利用可能なエイリアス: within_url_description:
(新しい) 拡張ページ説明メタデータのエンリッチメントに対してキーワード/フレーズによるマッチングを実行します。 | entities.urls.unwound.description |
| url_title: | PowerTrack | 利用可能な別名: within_url_title:
(新しい) 拡張 URL タイトル メタデータ エンリッチメント に対してキーワード/フレーズによるマッチングを行います。 | entities.urls.title |