このページでは、Filtered Stream の ルール作成 で利用可能なオペレーターの完全な一覧を提供します。
オペレーターは、投稿の特定の属性にマッチさせるために使用します。次の 2 種類があります:
- スタンドアロンオペレーター — 単独でも、他のオペレーターと組み合わせても使用可能
- 接続必須オペレーター — 少なくとも 1 つのスタンドアロンオペレーターと組み合わせて使用する必要があります
ほとんどのオペレーターは Pay-per-use と Enterprise の両方で利用可能です。一部の高度なオペレーター (セマンティック embedding など) は、追加のティアアクセスを伴う Enterprise が必要です。
キーワードおよびフレーズオペレーター
| Operator | Type | Summary | Example |
|---|
keyword | Standalone | 投稿本文内のキーワードにマッチ (トークン化マッチ) | pepsi OR cola OR "coca cola" |
emoji | Standalone | 投稿本文内の絵文字にマッチ | (😃 OR 😡) 😬 |
"exact phrase" | Standalone | 投稿本文内の完全一致フレーズにマッチ | ("X API" OR #v2) -"filtered stream" |
"keyword1 keyword2"~N | Standalone | 近接マッチ — 互いに N トークン以内のキーワード (最大 N=6) | "social media"~5 |
エンティティオペレーター
| Operator | Type | Summary | Example |
|---|
# | Standalone | ハッシュタグを含む投稿にマッチ (完全一致) | #thankunext #fanart |
@ | Standalone | ユーザー名へのメンションを含む投稿にマッチ | (@XDevelopers OR @api) -@x |
$ | Standalone | キャッシュタグを含む投稿にマッチ | $twtr OR @XDevelopers -$fb |
ユーザーオペレーター
| Operator | Type | Summary | Example |
|---|
from: | Standalone | 特定のユーザーからの投稿にマッチ | from:XDevelopers OR from:api |
to: | Standalone | 特定のユーザーへの返信にマッチ | to:XDevelopers OR to:api |
retweets_of: | Standalone | 特定のユーザーのリポストにマッチ | retweets_of:XDevelopers |
from_affiliate_of: | Standalone | 特定のユーザーのアフィリエイトからの投稿にマッチ | from_affiliate_of:XDevelopers |
to_affiliate_of: | Standalone | 特定のユーザーのアフィリエイトへの返信にマッチ | to_affiliate_of:XDevelopers |
URL オペレーター
| Operator | Type | Summary | Example |
|---|
url: | Standalone | URL のトークン化マッチ (url または expanded_url フィールドにマッチ) | url:"https://developer.x.com" |
url_title: | — | 展開された URL の HTML タイトルメタデータに対するキーワードマッチ | url_title:snow |
url_description: | — | 展開されたページの説明メタデータに対するキーワードマッチ | url_description:weather |
url_contains: | — | URL コンテンツに対するリテラルマッチ | url_contains:photos |
コンテキストおよびエンティティオペレーター
| Operator | Type | Summary | Example |
|---|
context: | Standalone | 特定のドメイン/エンティティのペアを持つ投稿にマッチ | context:10.799022225751871488 または context:47.* |
entity: | Standalone | 特定のエンティティ文字列値を持つ投稿にマッチ | entity:"Michael Jordan" |
conversation_id: | Standalone | 会話スレッド内の投稿にマッチ | conversation_id:1334987486343299072 |
ユーザープロフィールオペレーター
| Operator | Type | Summary | Example |
|---|
bio: | Standalone | 投稿者の自己紹介内のキーワードにマッチ | bio:developer OR bio:"data engineer" |
bio_name: | Standalone | 投稿者の名前内のキーワードにマッチ | bio_name:phd OR bio_name:md |
bio_location: | Standalone | 投稿者の所在地内のキーワードにマッチ | bio_location:"big apple" OR bio_location:nyc |
ロケーションオペレーター
| Operator | Type | Summary | Example |
|---|
place: | Standalone | ロケーションタグ付きの投稿にマッチ | place:"new york city" OR place:seattle |
place_country: | Standalone | 国コードを持つ投稿にマッチ | place_country:US OR place_country:MX |
point_radius: | Standalone | ある地点の半径内の投稿にマッチ | point_radius:[2.355128 48.861118 16km] |
bounding_box: | Standalone | バウンディングボックス内の投稿にマッチ | bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
投稿タイプオペレーター
| Operator | Type | Summary | Example |
|---|
is:retweet | Conjunction required | リポストにマッチ | data @XDevelopers -is:retweet |
is:reply | Conjunction required | 返信にマッチ | from:XDevelopers is:reply |
is:quote | Conjunction required | 引用投稿にマッチ | "sentiment analysis" is:quote |
is:verified | Conjunction required | 認証済みアカウントの投稿にマッチ | #nowplaying is:verified |
-is:nullcast | Conjunction required | プロモーション投稿を除外 (否定形での使用が必須) | "mobile games" -is:nullcast |
コンテンツタイプオペレーター
| Operator | Type | Summary | Example |
|---|
has:hashtags | Conjunction required | ハッシュタグを含む投稿にマッチ | from:XDevelopers -has:hashtags |
has:cashtags | Conjunction required | キャッシュタグを含む投稿にマッチ | #stonks has:cashtags |
has:links | Conjunction required | リンクを含む投稿にマッチ | from:XDevelopers has:links |
has:mentions | Conjunction required | メンションを含む投稿にマッチ | #nowplaying has:mentions |
has:media | Conjunction required | メディア (写真、GIF、動画) を含む投稿にマッチ | (kittens OR puppies) has:media |
has:images | Conjunction required | 画像を含む投稿にマッチ | #meme has:images |
has:video_link | Conjunction required | ネイティブの X 動画を含む投稿にマッチ | #icebucketchallenge has:video_link |
has:geo | Conjunction required | ジオロケーションデータを含む投稿にマッチ | recommend #paris has:geo |
サンプリングおよび言語オペレーター
| Operator | Type | Summary | Example |
|---|
sample: | Conjunction required | ランダムな割合のサンプル (1-100) を返す | #nowplaying @spotify sample:15 |
lang: | Conjunction required | 特定の言語に分類された投稿にマッチ | recommend #paris lang:en |
ユーザーメトリクスオペレーター
| Operator | Type | Summary | Example |
|---|
min_followers: | — | 指定した数以上のフォロワーを持つユーザーの投稿にマッチ | min_followers:1000 |
followers_count: | — | フォロワー数が範囲内のユーザーの投稿にマッチ | followers_count:1000..10000 |
tweets_count: | — | 投稿数が範囲内のユーザーの投稿にマッチ | tweets_count:1000..10000 |
following_count: | — | フォロー数が範囲内のユーザーの投稿にマッチ | following_count:1000..10000 |
listed_count: | — | 指定した数のリストに登録されているユーザーの投稿にマッチ | listed_count:10..100 |
投稿参照オペレーター
| Operator | Type | Summary | Example |
|---|
in_reply_to_tweet_id: | — | 特定の投稿への返信にマッチ | in_reply_to_tweet_id:1539382664746020864 |
retweets_of_tweet_id: | — | 特定の投稿のリポストにマッチ | retweets_of_tweet_id:1539382664746020864 |
source: | — | 特定のソースアプリケーションからの投稿にマッチ | source:"X for iPhone" |
論理オペレーター
| Operator | Summary | Example |
|---|
OR | 式間の論理 OR | cat OR dog |
| Space (AND) | 式間の論理 AND | cat dog (両方必須) |
() | 複雑な式のためのグループ化 | (cat OR dog) -is:retweet |
- | 否定/除外 | cat -grumpy |
埋め込みオペレーター
Enterprise 限定 — Embedding ティアが必要embedding: および embedding_threshold: オペレーターは、Filtered Stream 向けに Embedding ティアアクセスがプロビジョニングされた Enterprise アカウントでのみ利用可能です。サポートされていないティアでは、ルール作成は “unavailable operator” エラーで拒否されます。有効化についてはアカウント担当者にお問い合わせください。
| Operator | Type | Summary | Example |
|---|
embedding:"query" | Standalone | クエリと意味的に類似した投稿にマッチ。複数語のクエリは引用符で囲む必要があります。 | embedding:"climate change policy" |
embedding_threshold:X.XX | Conjunction required | マッチに必要な最小コサイン類似度 (0.0–1.0)。デフォルトは 0.3。0.3–0.6 の範囲の値を使用してください。 | embedding:"cryptocurrency regulation" embedding_threshold:0.45 |
主な要件と注意点
embedding_threshold: は、ルール内で 唯一のオペレーター にはできません。embedding: (または他のスタンドアロンオペレーター) と組み合わせてください。embedding: を 否定しないでください (例: -embedding:"..." はサポートされていません)。- 短いキーワードよりも、長く説明的な自然言語のクエリの方が良い結果を生み出します。
- 埋め込みクエリの処理は非同期です — 新しく作成されたルールがマッチを開始するまでに数秒かかる場合があります。
- 投稿が埋め込みルールでマッチした場合、配信されるペイロードの
matching_rules エントリには embedding_similarity と embedding_threshold が含まれます (投稿とルールのマッチング を参照)。
ルールの例:
embedding:"electric vehicle announcements" lang:en -is:retweet has:linksembedding:"natural disaster relief" embedding_threshold:0.45 has:mediaembedding:"renewable energy" embedding_threshold:0.4 OR embedding:"solar power investment"
対応言語
lang: オペレーターは以下の BCP 47 言語コードに対応しています:
| Language | Code | Language | Code | Language | Code |
|---|
| アムハラ語 | am | ギリシャ語 | el | ポルトガル語 | pt |
| アラビア語 | ar | グジャラート語 | gu | ルーマニア語 | ro |
| アルメニア語 | hy | ヘブライ語 | iw | ロシア語 | ru |
| バスク語 | eu | ヒンディー語 | hi | セルビア語 | sr |
| ベンガル語 | bn | ハンガリー語 | hu | 簡体字中国語 | zh-CN |
| ブルガリア語 | bg | インドネシア語 | in | スロバキア語 | sk |
| カタルーニャ語 | ca | イタリア語 | it | スロベニア語 | sl |
| クロアチア語 | hr | 日本語 | ja | スペイン語 | es |
| チェコ語 | cs | カンナダ語 | kn | スウェーデン語 | sv |
| デンマーク語 | da | 韓国語 | ko | タミル語 | ta |
| オランダ語 | nl | ラトビア語 | lv | テルグ語 | te |
| 英語 | en | リトアニア語 | lt | タイ語 | th |
| エストニア語 | et | マラヤーラム語 | ml | 繁体字中国語 | zh-TW |
| フィンランド語 | fi | マラーティー語 | mr | トルコ語 | tr |
| フランス語 | fr | ノルウェー語 | no | ウクライナ語 | uk |
| ドイツ語 | de | ペルシャ語 | fa | ウルドゥー語 | ur |
| グルジア語 | ka | ポーランド語 | pl | ベトナム語 | vi |
次のステップ
ルールを作成する
ルールの構文とベストプラクティスを学ぶ
Filtered Stream の概要
Filtered Stream を使い始める
