メインコンテンツへスキップ
このページでは、Filtered Stream v2 のルールを作成する際に使用できる演算子の一覧を紹介します。

演算子一覧

注: 一部の演算子には別名(エイリアス)が用意されています。
オペレーター種類概要
keyword単体Post の本文内のキーワードに一致します。これはトークン化に基づくマッチであり、指定したキーワード文字列は Post 本文のトークン化済みテキストと照合されます。トークン化では、単語は句読点、記号、Unicode 基本多言語面の区切り文字に基づいて分割されます。
たとえば、テキスト「I like coca-cola」を含むPostは、次のトークンに分割されます:I、like、coca、cola。これらのトークンは、ルールで使用するキーワード文字列と比較されます。句読点(例:coca-cola)や記号、区切り文字を含む文字列に一致させるには、キーワードを二重引用符で囲む必要があります。

例:pepsi OR cola OR "coca cola"
emoji単体Post 本文内の絵文字に一致します。キーワードと同様に、絵文字はトークン化による一致であり、指定した絵文字は Post 本文のトークン化されたテキストに対して照合されます。

絵文字にバリアントがある場合は、ルールに追加する際に必ず二重引用符で囲んでください。

例:(😃 OR 😡) 😬
"フレーズの完全一致"単体Post の本文内でフレーズに完全一致します。

例:("X API" OR #v2) -"filtered stream"
"keyword1 keyword2"~N単体キーワードが一定の近接範囲内にあるPostに一致させる近接演算子N互いの距離が N トークン以内であれば一致します。
逆順のキーワードは、最大で次の数までに制限されますN-2トークン間の距離Nより大きくできません6.

例:"social media"~5 OR "API"~3
#単体ハッシュタグがPost内で認識済みのエンティティである場合、認識済みのハッシュタグを含む任意のPostに一致します。

このオペレーターは厳密一致であり、トークン化による一致ではありません。つまり、このルール#thankyouは、ハッシュタグ #thanku を正確に含む投稿には一致しますが、#thankunext のハッシュタグを含む投稿には一致しません。

例:#thankunext #fanart OR @arianagrande
@単体指定したユーザー名が認識済みのエンティティである場合(@ 文字を含む)、そのユーザー名に言及しているあらゆるPostに一致します。

例:(@XDevelopers OR @api) -@x
$単体指定された値を含む任意のPostにマッチします’キャッシュタグ(Cashtag)‘(トークンの先頭文字が「」である場合)<br /><br />なお、cashtag オペレーターは X の「symbols」エンティティ抽出に依存します。&#39;s&#39;記号&#39;本文からcashtagを直接抽出しようとするのではなく、cashtagに一致させるために(Xの)symbolsエンティティによる抽出を使用します。<br /><br />例:`twtr OR @XDevelopers -$fb`
from:単体特定のユーザーによる任意のPostに一致します。
値には、ユーザー名(@ を除く)またはユーザーの数値ユーザーIDのいずれかを指定できます’数値のユーザーID。

ユーザー名/id は1つだけ指定できますfrom:演算子。

例:from:XDevelopers OR from:api -from:X
宛先:単体特定のユーザーに対する返信である任意のPostと一致します。
値は、ユーザー名(@ を除く)またはユーザーの数値ユーザー ID のいずれかです’数値のユーザーID。

to: オペレーターごとに指定できるユーザー名/id は 1 つだけです宛先:オペレーター。

例:to:XDevelopers OR to:api -to:x
url:単体Post の正しく形式化された任意の URL に対して、トークン化マッチを実行します。

このオペレーターは、urlexpanded_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"
entities.urls.expanded_url の内容と一致するため)entities.urls.expanded_url)

from:XDevelopers url:"https://t.co"
entities.urls.expanded_url の内容と一致するため)entities.urls.url)

句読点や特殊文字を含むトークンやフレーズは、二重引用符で囲んでください(例:url:"/developer")。同様に、特定のプロトコルに一致させるには、二重引用符で囲みます(例:url:"https://developer.x.com")。

1 つの URL しか指定できませんurl:オペレーター。
retweets_of:単体利用可能な別名: retweets_of_user:
指定したユーザーのRetweetであるPostに一致します。値には、ユーザー名(@ を除く)またはユーザーの数値ユーザーIDのいずれかを使用できます’の数値のユーザーID。

ユーザー名または id は 1 つだけ渡せますretweets_of:演算子。

例:retweets_of:XDevelopers OR retweets_of:twitterapi
参照してくださいこちら数値のXアカウントIDを調べる方法についてはこちらをご覧ください。
context:単体特定のドメイン id および/または ドメイン id とエンティティ id のペアに一致するPostを抽出します。ここで * はワイルドカードを表します。このオペレーターの詳細は、当社のページをご覧くださいPost のアノテーション.

context: オペレーターごとに指定できるドメイン/エンティティは1つのみですコンテキスト:オペレータ。

context:domain_id.entity_id
context:domain_id.*
context:*.entity_id

例:
context:10.799022225751871488
(domain_id.entity_id指定のドメインとエンティティのペアに一致するPostを返します)

context:47.*
(domain_id.*そのドメインIDに一致するPostを、任意のドメインとエンティティのペアで返します

context:*.799022225751871488
(*.entity_id*.entity_id は、そのエンティティIDに一致する Posts を、任意のドメインとエンティティの組み合わせで返します)
entity:単体特定のエンティティの文字列値に一致するPostを返します。このオペレーターの詳細は、こちらのページをご覧くださいアノテーション.

1つの entity: オペレーターにつき、指定できるエンティティは1つだけですentity:演算子。

entity:"エンティティ/場所の文字列表現"

例:entity:"Michael Jordan" OR entity:"Barcelona"
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)
自己紹介:単体利用可能なエイリアス: user_bio:
Post の投稿者フィールド内のキーワードまたはフレーズに一致します’の自己紹介。これは、内容内でのトークン化された一致です説明内のフィールドユーザーオブジェクト.

例:bio:developer OR bio:"data engineer" OR bio:academic
bio_name:単体Postの投稿者に含まれるキーワードに一致します’s ユーザーのプロフィール名。これはユーザーコンテンツ内でのトークン化された一致です’s”名前”内のフィールドユーザーオブジェクト.

例:bio_name:phd OR bio_name:md
bio_location:単体利用可能な別名: user_bio_location:
指定したキーワードまたはフレーズを含むロケーションを設定しているユーザーが公開したPostに一致します。このオペレーターは、メッセージ本文に対する通常のキーワードルールと同様に、トークン化マッチを行います。

この場所は、次の一部ですユーザーオブジェクト、〜に一致します’場所’フィールドであり、正規化されていないユーザー生成の自由形式文字列です。また、Postとは異なります’の位置(参照place:).

例:bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan
place:単体指定した場所名またはXのplace IDがタグ付けされたPostに一致します。複数語の地名(“New York City”、“Palo Alto”)は引用符で囲んでください。

place: 演算子には、1回につき場所を1つだけ指定できますplace:オペレーター。

注記: 次を参照:GET geo/searchX のプレイス ID を取得する方法については、standard v1.1 のエンドポイント GET geo/search を参照してください。

注: このオペレーターはRetweetにはマッチしません。Retweet’の「場所」は元のPostに付与されたものに限定されます。また、Quote Tweetの元のPostに付与された「場所」には一致しません。

例:place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:単体タグ付けされた場所(ロケーション)に関連付けられた国コードが、指定された ISO アルファ2文字コードと一致する Post を照合します。

有効な ISO コードの一覧は以下で確認できますウィキペディア.

place_country: 演算子ごとに指定できる ISO コードは 1 つのみですplace_country:オペレータ。

Note: このオペレーターはリツイートには一致しません。リツイートは’s の場所は元のPostに関連付けられます。また、Quote Tweetの元のPostに関連付けられている場所にも一致しません。

例:place_country:US OR place_country:MX OR place_country:CA
point_radius:単体に一致しますplace.geo.coordinates存在する場合は Post の place.geo.coordinates オブジェクトに対して、また X では、定義されたリージョン内に Place のポリゴンが完全に収まる場所のジオポリゴンに対して適用されます。

point_radius:[経度 緯度 半径]

- 半径の単位はマイル(mi)とキロメートル(km)に対応しています
- 半径は25マイル未満である必要があります
- 経度は±180の範囲です
- 緯度は±90の範囲です
- すべての座標は小数度で表記されています
- ルールの引数は角括弧内に記述し、スペースで区切ります

point_radius: オペレーターごとに指定できるジオポリゴンは1つのみですpoint_radius:演算子。

Note: このオペレーターはリツイートには一致しません。リツイートは’s の場所は元の Post に付随します。Quote Tweet の元の Post に付随する場所にも一致しません。

例:point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:単体使用可能なエイリアス: geo_bounding_box:
存在する場合は Post の place.geo.coordinates オブジェクトに対して、また X では場所のジオポリゴンに対して照合されます。場所のポリゴンが定義された領域内に完全に含まれている場合に一致します。

bounding_box:[west_long south_lat east_long north_lat]

-west_long south_latバウンディングボックスの南西端を表し、ここでwest_longはその点の経度で、south_latは緯度を表します。
-east_long north_latバウンディングボックスの北東端を表し、ここではeast_longはその点の経度で、north_latは緯度を表します。
- バウンディングボックスの幅と高さは 25mi 未満である必要があります
- 経度は±180の範囲です
- 緯度は±90の範囲
- すべての座標は小数度で表されます。
- ルールの引数は角括弧内に含め、スペース区切りにします。

bounding_box: オペレーターでは、指定できる地理ポリゴンは1つだけですbounding_box:演算子。

Note: このオペレーターはリツイートにはマッチしません。理由は、リツイート’s の場所は元のPostに付加されます。また、Quote Tweetの元のPostに付加された場所にもマッチしません。

例:bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet接続詞が必要です指定したルールのその他の条件にも合致するRetweetに一致します。このオペレーターは、いわゆる「本物の」Retweet(たとえば、Retweetボタンを使って生成されたもの)だけを検出します。Quote Tweetには一致しません。

例:data @XDevelopers -is:retweet
is:reply接続詞が必要ですルールに一致する明確な返信のみを配信します。否定を指定すると、ルールに一致する返信を配信から除外できます。

フィルタ済みストリームで使用すると、このオペレーターは元のPostへの返信、引用されたPost内の返信、およびRetweet内の返信に一致します。

例:from:XDevelopers is:reply
is:quote接続詞が必要ですコメント付きのPost(Quote Tweet)をすべて返します。

例:"感情分析" is:quote
is:verified接続詞が必要ですX によって認証済みの作者が作成した Post のみを配信します。

例:#nowplaying is:verified
-is:nullcast接続詞が必要ですads.twitter.com 上でプロモーション専用として作成された Post を、次のいずれかのsource:"広告主向けTwitter(レガシー)"またはsource:"広告主向けTwitter".
この演算子は否定しなければなりません。

Nullcast された Post の詳細については、次のページをご覧ください:Post の利用可否.

例:"モバイル ゲーム" -is:nullcast
has:hashtags接続詞が必要です少なくとも1つのハッシュタグを含むPostにマッチします。

例:from:XDevelopers -has:hashtags
has:cashtags接続詞が必要です先頭にカッシュタグ記号()が付いたPostを含むものにマッチします&#39;‘文字。たとえば、$tag)。

例:#stonks has:cashtags
has:links接続詞が必要ですこの演算子は、Post 本文にリンクとメディアを含む Post を照合します。

例:from:XDevelopers announcement has:links
has:mentions接続詞が必要です他のXユーザーへの言及を含むPostに一致します。

例:#nowplaying has:mentions
has:media接続詞が必要です利用可能なエイリアス: has:media_link
X によって判定された、写真、GIF、動画などのメディアオブジェクトを含む Post に一致します。Periscope で作成されたメディアや、他のメディアホスティングサイトへのリンクを含む Post には一致しません。

例:(kittens OR puppies) has:media
has:images接続詞が必要です画像への認識済みURLを含むPostにマッチします。

例:#meme has:images
has:video_link接続詞が必要です利用可能な別名: has:videos
X に直接アップロードされたネイティブな X 動画を含む Post に一致します。Periscope で作成された動画や、他の動画ホスティングサイトへのリンクを含む Post には一致しません。

例:#icebucketchallenge has:video_link
has:geo接続詞が必要ですX ユーザーが提供した、Post 固有のジオロケーション data を持つ Post に一致します。これは、対応する表示名、ジオポリゴン、その他の fields を伴う X の place 形式の位置情報、またはまれに緯度・経度のジオ座標のいずれかです。

注: 場所(Post の地理情報)で一致を判定するオペレーターは、元の投稿に対する一致のみを含みます。リツイートには場所のデータは含まれません。

例:recommend #paris has:geo -bakery
sample:接続詞が必要ですルールに一致するPostsの全体ではなく、ランダムな割合サンプルを返します。割合は1〜100の整数で指定する必要があります(たとえば、sample:10はランダムな10%のサンプルを返します)。

このオペレーターはまず、指定した割合までストリームの対象を絞り込み、そのサンプル化された部分集合にルール/フィルターを適用します。言い換えると、たとえば…、sample:10、各Postがサンプルに含まれる確率は10%です。

この演算子はルール全体に適用され、すべての OR 条件をグループ化することが求められます’OR で結合した用語は、すべてグループ化する必要があります。

例:#nowplaying @spotify sample:15
lang:接続詞が必要ですX によって特定の言語に分類された Post にマッチします(投稿が分類されている場合に限ります)。各 Post は現時点では1つの言語にしか分類されないため、複数の言語を AND で組み合わせても結果は返されません。

1 つの BCP 47 言語識別子のみを渡すことができますlang:オペレータ。

注: 言語分類ができない場合、返される結果は「und」(未定義)になります’and’(未定義の場合)

例:recommend #paris lang:en

以下のリストは、現在サポートされている言語とそれに対応する BCP 47 の言語識別子を示しています。

言語BCP 47
*-
アムハラ語am
アラビア語ar
アルメニア語hy
バスク語eu
ベンガリー語bn
ボスニア語bs
ブルガリア語bg
ミャンマー語my
クロアチア語hr
カタロニア語ca
チェコ語cs
デンマーク語da
オランダ語nl
英語英語版
エストニア語et
フィンランド語fi
フランス語fr
ジョージア語ka
ドイツ語de
ギリシャ語el
グジャラート語gu
ハイチ・クレオールht
ヘブライ語he
ヒンディー語こんにちは
ラテン文字化したヒンディー語hi-Latn
ハンガリー語hu
アイスランド語is
インドネシア語in
イタリア語it
日本語ja
カンナダ語kn
クメール語km
韓国語ko
ラオス語lo
ラトビア語lv
リトアニア語lt
マラヤーラムml
ディベヒ語(モルディブ語)dv
マラーティー語mr
ネパール語ne
ノルウェー語なし
オリア語または
パンジャブ語pa
パシュトーps
ペルシャ語fa
ポーランド語pl
ポルトガル語pt
ルーマニア語ro
ロシア語ru
セルビア語sr
簡体中国語zh-CN
シンド語sd
シンハラsi
スロバック語sk
スロベニア語sl
ソラニー・クルド語ckb
スペイン語es
スウェーデン語sv
タガログtl
タミル語ta
テルグ語te
タイ語th
チベット語bo
繁体字中国語zh-TW
トルコ語tr
ウクライナ語uk
ウルドゥー語ur
ウイグル語ug
ベトナム語vi
ウェールス語cy
followers_count:著者のフォロワー数が指定した範囲内にあるPostに一致します。
単一の数値を指定した場合、その数値以上の値が一致します。

例:followers_count:500

また、指定した範囲内の任意の数に一致するように範囲を設定できます。

例:followers_count:1000..10000
tweets_count:利用可能な別名: statuses_count:
著者が投稿したPostの数が指定された範囲内にある場合に、Postを一致対象とします。
単一の数値を指定した場合、その数値以上の任意の値が一致します。

例:tweets_count:1000

さらに、範囲を指定して、その範囲内の任意の数値にマッチさせることができます。

例:tweets_count:1000..10000
following_count:利用可能な別名: friends_count:
著者のフォロー数(フォローしているユーザー数)が指定した範囲内にあるPostに一致します。
単一の数値を指定すると、その値以上の数値がすべて一致します。

例:following_count:500

また、範囲を指定して、その範囲内の任意の数値にマッチさせることもできます。

例:following_count:1000..10000
listed_count:使用可能なエイリアス: user_in_lists_count:
著者が指定された数の List に含まれている場合に Post に一致します。
単一の数値を指定すると、その値以上の任意の数値がマッチします。

例:listed_count:10

さらに、範囲を指定して、その範囲内の任意の数値にマッチさせることができます。

例:listed_count:10..100
url_title:使用可能なエイリアス: within_url_title:
展開されたURLのHTMLタイトルのメタデータに対して、キーワード/フレーズのマッチを行います。

例:url_title:snow
url_description:利用可能な別名: within_url_description:
展開済みのページ説明メタデータに対してキーワード/フレーズのマッチングを行います。

例:url_description:weather
url_contains:指定したフレーズまたはキーワードを文字どおり含むURLを持つPostに一致します。句読点を含むパターン(例:google.com)を検索する場合は、検索語を引用符で囲んでください。
注記: これは展開後のURLにもマッチします。

例:url_contains:photos
source:指定されたソースのアプリケーションによって生成された任意のPostに一致します。値はアプリケーション名、またはアプリケーションの’s の URL。単体では使用できません。

例:source:"iPhone 版 X"

注意: X の App 開発者の場合、あなたのアプリケーションによってプログラムで作成された Post には、app settings で設定したアプリケーションの Name と Website URL が source として表示されますApp の設定
in_reply_to_tweet_id:利用可能な別名: in_reply_to_status_id:
指定されたPostへの明示的な返信のみを返します。

例:in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:使用可能なエイリアス: retweets_of_status_id:
指定したPostの明示的(またはネイティブ)Retweetのみを返します。使用するステータスIDはRetweetではなく、元のPostのIDである必要がある点に注意してください。

例:retweets_of_tweet_id:1539382664746020864