ルールとフィルタリング：エンタープライズ

エンタープライズのルールとクエリの始め方

エンタープライズオペレーターを利用するプロダクトは、設定したフィルタリングルールに基づいてソーシャルデータを提供します。ルールは1つ以上の「句」から構成され、句とはキーワード、完全一致のフレーズ、または多数あるエンタープライズオペレーターのいずれかを指します。エンタープライズオペレーターでルールの作成を始める前に、以下で説明する構文を確認し、利用可能なオペレーター一覧に目を通し、ルール作成に関する制約を理解してください。また、ルールがどのように論理的に評価されるかの詳細については、「演算の順序」セクションも必ず確認してください。複数の句は “and” と “or” の両方のロジックで組み合わせられます。 注意: 「and」のロジックは句と句の間のスペースで指定し、or のロジックは大文字の OR で指定します。各ルールは最大2,048文字までで、ポジティブな句（マッチまたはフィルタしたい対象）およびネガティブな句（除外してマッチさせたくない対象）の数に制限はありません。

ルールとクエリの作成

キーワード一致 キーワード一致は検索インターフェースでのクエリに似ています。たとえば、次のエンタープライズ向けオペレーターのルールは、本文に「social」という語を含むアクティビティに一致します。 social 空白による用語の AND（論理積） キーワードを追加すると、一致のための条件が1つ増えることになります。たとえば、このルールは、本文に「social」と「media」が両方存在するアクティビティにのみ一致します（順不同）。用語の間にスペースを入れると、ブール AND として動作します。ルールに明示的な AND を含めると、rules エンドポイントで拒否されます。 social media 大文字の OR による用語の OR（論理和） 多くの場面ではブール OR が必要になります。これは簡単に実現できます。OR オペレーターは大文字である必要があり、小文字の ‘or’ は通常のキーワードとして扱われます。 social OR data 用語の否定 特定のキーワードを含む結果を除外したい（ブール NOT）場合もあります。たとえば、「happy」を含みつつ、本文に「birthday」を含むものは除外する、といったケースです。 social -personality かっこによるグループ化 これらのロジックは、かっこでグループ化して組み合わせることで、より複雑なクエリへ拡張できます。 (social OR data) (academic OR research) -personality -information -university これはほんの始まりにすぎません。上記の例はキーワードのトークン化によるマッチングのみを用いていますが、エンタープライズ製品ではテキストに対して異なる種類のマッチングを行うためのオペレーターも提供しています。 完全一致 "social media research" 部分文字列一致 contains:info 近接一致 "social media research"~3 さらに、テキスト以外にも、ソーシャルデータの固有の側面でフィルタリングできるその他のオペレーターもあります。 Post を投稿しているユーザー from:XDevelopers 米国コロラド州ボルダーの Pearl St. から半径 10 マイル以内のジオタグ付き Tweets point_radius:[-105.27346517 40.01924738 10.0mi] すべてを組み合わせる これらは、上記と同じ種類のロジックでテキストフィルターと組み合わせられます。

(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

ブール構文

前のセクションの例では、さまざまな種類のブールロジックとグルーピングを使用しました。各種の構文と要件の詳細は、以下の表を参照してください。


ロジックの種類	演算子の構文	説明
AND	social data	2つの演算子の間に空白を入れると、その間は AND ロジックになります。両方のキーワード（“social” と “data”）を含むアクティビティに一致します。ルール内で AND を明示的に使用しないでください。空白のみを使用してください。明示的な AND は通常のキーワードとして扱われます。
OR	social OR data	2つの演算子を OR で結合するには、両者の間に空白で囲まれた全大文字の OR を挿入します。いずれかのキーワード（“social” または “data”）を含むアクティビティに一致します。 1つのルールで OR と AND の機能を組み合わせる場合は、“演算の順序” セクションで説明している演算の順序を理解し、下記のとおり括弧を使用して非否定の演算子をグループ化し、ルールが想定どおりに動作するように検討してください。ルールでは大文字の “OR” を使用する必要があります。小文字の ‘or’ は通常のキーワードとして扱われます。
NOT	social data -apple -android -phone	演算子または演算子のグループの直前に `-` 文字を挿入します。示した例のルールはキーワード “social” を含むアクティビティに一致しますが、キーワード “data” を含むものは除外します。否定された OR は、ルールが「ファイアホースのすべて（否定以外）を要求する」ことになる場合は許可されません。たとえば、`apple OR -ipad` は、“ipad” に言及しているもの以外のすべてのアクティビティに一致してしまうため無効です。
グルーピング	(social OR data) -XDevelopers -api	複数の演算子を括弧で囲むと機能的な「グループ」を作成します。グループは、個々の節と同様に空白（AND）または OR で節に接続できます。ただし、ベストプラクティスとして、グループ全体に否定の - を適用して否定をまとめないでください。代わりに、各演算子を個別に否定し、空白（AND）で連結します。たとえば、-(iphone OR imac OR macbook) を使用する代わりに、次を使用します: -iphone -imac -macbook グルーピングは、評価に使用される演算の順序のため、1つのルールで AND と OR の機能を組み合わせる場合に特に重要です。詳細は以下を参照してください。

注意: 演算子は肯定にも否定にもなり得ます。 肯定の演算子 は、結果に含めたいものを定義します。例: has:hashtags 演算子は「ハッシュタグを含むアクティビティが欲しい」という意味です。 否定の演算子 は、結果から除外したいものを定義し、上記で説明したブールの NOT ロジックを使用して作成します。たとえば、-has:hashtags は「たとえ他の条件に合致しても、ハッシュタグを含むアクティビティは除外する」という意味です。 Premium operator products では、肯定・否定の節の数に制限はなく、最大長 2,048 文字の制限のみが適用されます。

演算の順序

1つのルール内で AND と OR を組み合わせる場合、評価は次の優先順位で行われます。

AND ロジックで接続された演算子が先に結合される
次に、OR ロジックで接続された演算子が適用される

例:

apple OR iphone ipad は apple OR (iphone ipad) と評価されます
ipad iphone OR android は (iphone ipad) OR android と評価されます

あいまいさを避け、意図どおりに評価されるよう、必要に応じて丸括弧で用語をまとめてください。例:

(apple OR iphone) ipad
iphone (ipad OR android)

句読点、ダイアクリティカルマーク、大小文字の区別

エンタープライズ向けオペレーターで、アクセントやダイアクリティカルマークを含むキーワードまたはハッシュタグのルールを指定した場合、Post本文に対してそれらのダイアクリティカルマークを考慮してマッチします。キーワード Diacr**í**tica またはハッシュタグ #cumplea**ñ**os のルールは「Diacrítica」や「#cumpleaños」にはマッチしますが、チルダのない「Diacritica」や「#cumpleanos」にはマッチしません（í や eñe が必要）。アクセントやダイアクリティカルマーク付きの文字は通常の文字と同様に扱われ、単語境界としては扱われません。例えば、cumpleaños のルールは、単語 cumpleaños を含むアクティビティにのみマッチし、cumplea、cumplean、または os を含むアクティビティにはマッチしません。すべてのオペレーターは大文字小文字を区別せずに評価されます。例えば、ルール Cat は次のすべてにマッチします: “cat”, “CAT”, “Cat”。

PowerTrack のルールタグ

「Matching rules」ページで説明しているとおり、各ルールにはタグを付与できます。これらのタグはフィルタリングには影響しませんが、アプリ内でルールを論理的にグループ化するために使用できます。各ルールに付与できるタグは 1 つのみで、最大 255 文字です。タグは、同「Matching rules」ページで説明しているとおり、API を介して作成する際に JSON 形式のルールに含められます。

ルールをJSON形式にする

API経由でストリームにルールを追加または削除するには、ルールはJSON形式である必要があります。基本的には、各ルールを次の構造に収めます。 {"value":"insert_rule_here"} 二重引用符を含むルール ルールに、完全一致やその他のオペレーターに関連する二重引用符（“）が含まれる場合は、JSONの構造と区別するためにバックスラッシュでエスケープする必要があります。 "social data" @XDevelopers JSON形式のルールは次のようになります。 {"value":"\"social data\" @XDevelopers"} 二重引用符の文字列リテラルを含むルール 完全一致内で二重引用符を文字列リテラルとして含めるには、二重にエスケープする必要があります。たとえば、正確なフレーズ “Toys “R” Us” に一致させ、“R” を囲む二重引用符を含める場合、プレーンテキストでの表現は次のとおりです。 "Toys \"R\" Us" これをJSON形式にする場合は、次の構造を使用します。 {"value":"\"Toys \\\"R\\\" Us\""} タグ付きのルール 上記のとおり、ルールに任意のタグを含めるには、ルール値に加えて tag フィールドを追加します。 {"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"} APIリクエストのフォーマット API経由でストリームに対してルールを追加または削除する場合、複数のJSON形式のルールはカンマで区切り、以下のようにJSONの「rules」配列でラップします。 {"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

引用ツイートにマッチするオペレーター

PowerTrack API および Historical PowerTrack API を使用する場合、以下のオペレーターは、引用された元の Post と新しい引用ツイートの両方のコンテンツにマッチします。ただし、Search API を使用する場合、これらのオペレーターは引用ツイートの内容のみにマッチし、引用された元の Post のコンテンツにはマッチしません。

Keywords
Phrases
Proximity
#hashtags
@mentions
$cashtags
url:
url_contains:
has:links
has:mentions
has:hashtags
has:media
has:symbols
is:quote
is:reply

エンタープライズ向けオペレーター

以下は、PowerTrack および Historical PowerTrack で利用可能なオペレーターです。これらの一部は 30-Day および Full-Archive 検索 API でも利用できます。製品ごとの利用可能なオペレーター一覧はこちらの表をご覧ください。

オペレータ	概要
キーワード	Post の本文または URL に含まれるキーワードに一致します。キーワードは、数字（0〜9）または句読点以外の文字で始まっている必要があります。キーワードマッチングはトークン化方式で行われ、キーワードはPost本文のトークン化済みテキストと照合されます。句読点を含む文字列（例：“コカ・コーラ”)、引用符で囲まれた”フレーズの完全一致”. 例：`(social OR pizza OR wildfire) -planet`
絵文字	句読点・記号/絵文字・区切り文字に基づくトークナイズ済みの照合を用いて、Post の本文中の絵文字にマッチします。絵文字にバリアントがある場合は、完全一致を指定するために引用符を使用してください。例:`(🍕 OR 💜 OR 🐢) -🤖`
”フレーズの完全一致”	Post の本文内でフレーズの完全一致を検索します。句読点は空白として扱われます。例:`("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"`
#	指定したハッシュタグを含むPostに一致します。これは完全一致を意味し、`#2016`は、次を含むPostに一致します`#2016`ただし〜は含まない`#2016年選挙`. 例：`(#social OR #pizza OR #2016election) -#planet`
@	指定したユーザー名に言及しているPostのすべてに一致します。例：`(@XDevelopers OR @api OR @twittereng) -@jack`
”keyword1 keyword2”~N	キーワード同士がNトークン以内にあるPostに一致する近接演算子。逆順のキーワード同士の間隔は、最大でも N-2 トークンまでとします。N は 6 を超えられません。例：`"ソーシャルメディア"~5 OR "API"~3`
含まれるもの:	トークン化に関係なく、本文内で指定した部分文字列に一致するPostのサブストリング一致。空白や句読点を含む部分文字列には、二重引用符を使用してください。例:`(contains:social OR contains:"wikipedia.com") -contains:"buy now"`
差出人：	特定のユーザーの任意のPostに一致します。Xの数値アカウントIDまたはユーザー名（@を除く）で指定します`@`)。例：`(from:2244994945 OR from:api OR from:twittereng) -from:jack`
宛先:	特定のユーザーへの返信に該当する任意のPostに一致します（Xの数値アカウントIDまたはユーザー名で指定、`@`は除外）`@`）例:`(to:2244994945 OR to:api OR to:twittereng) -to:jack`
url:	投稿の展開済みURLに対して、トークン化（キーワード／フレーズ）による一致検索を行います。例：`@XDevelopers url:"developer.x.com"`
URL_title:	展開済みURLのHTMLタイトルのメタデータに対し、キーワード／フレーズ一致を行います。 PowerTrack および Historical PowerTrack でのみご利用いただけます。
URL_説明:	展開されたページ説明メタデータに対してキーワード／フレーズのマッチングを行います。 PowerTrack および Historical PowerTrack でのみご利用いただけます。
URL_含む：	指定したフレーズまたはキーワードを含むURLを持つPostに一致します。句読点を含む検索語句は、引用符で囲んでください。例:`(url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit`
自己紹介:	Post のユーザー自己紹介内のキーワードまたはフレーズに一致します。これはトークン化による一致で、‘概要’内にあるフィールドユーザーオブジェクト。例：`(bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll` 注:PowerTrack と Historical PowerTrack のみで利用可能です。
自己紹介_name:	Post のユーザーのプロフィール名内でキーワードに一致します。これは、User object の「name」フィールド内でのトークン化された一致です。ユーザーオブジェクト. 注:PowerTrack および Historical PowerTrack でのみご利用いただけます。
プロフィール_場所：	User オブジェクトが…である Post に一致’ユーザーの所在地が指定したキーワードまたはフレーズを含む場合に一致します。このオペレーターは、メッセージ本文に対する通常のキーワードルールと同様に、トークン化に基づくマッチングを行います。この場所は次の一部ですユーザーオブジェクト、アカウントの本拠地です’s’ホーム’場所。注記：PowerTrack および Historical PowerTrack でのみ利用可能。
ステータス_count:	指定された範囲内で、作者が投稿したステータス数に一致するPostを返します。単一の数値が指定された場合は、その数値以上であれば一致します。範囲を指定すると、その範囲内の任意の数値にマッチさせることができます（例、`statuses_count:1000..10000`) 例： `to:api statuses_count:10` 注記：PowerTrack と Historical PowerTrack でのみご利用いただけます。
フォロワー_count:	著者のフォロワー数が指定した範囲内にあるPostに一致します。単一の数値を指定すると、その数値以上の値が一致します。範囲を指定すると、その範囲内の任意の数値にマッチさせることができます（例、`followers_count:1000..10000`)。注釈:PowerTrack および Historical PowerTrack でのみ利用可能です。
友だち_count:	著者のfriends数（フォロー中ユーザー数）が指定した範囲内にあるPostに一致します。単一の数値を指定した場合、その数値以上のものが一致します。範囲を指定すると、その範囲内の任意の数値にマッチさせることができます（例、`friends_count:1000..10000`). 注記：PowerTrack および Historical PowerTrack でのみご利用いただけます。
掲載_count:	著者が指定された範囲内でX上のリストに一定回数以上追加されている場合に、該当するPostに一致します。単一の数値を指定すると、その値以上の数値に一致します。範囲を指定すると、その範囲内の任意の数値に一致させることができます（例、`listed_count:10..100`)。注記:PowerTrack および Historical PowerTrack でのみ利用できます。
$	指定された「キャッシュタグ」エンティティを含む任意のPostにマッチします。例：`($TWTR OR $TSLA OR $BRK.A) -$F` 注記：キャッシュタグ演算子はXのシンボルエンティティ抽出に依存しています’本文から直接抽出するのではなく、X の「symbols」エンティティ抽出を用いてキャッシュタグ（cashtag）を照合します。
リツイート数_of:	指定したユーザーのRetweetであるPostにマッチします。ユーザー名と数値のXアカウントIDの両方を受け付けます（PostのステータスIDではありません）。例：`(retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack`
リツイート_の_ステータス_id:	指定されたPostの明示的なRetweetのみを返します。Retweetではなく、オリジナルのPostのidを使用してください。サンプル：`retweets_of_status_id:1293593516040269825` 注釈:PowerTrack および Historical PowerTrack でのみ利用可能です。
内で_返信_宛て_ステータス_id:	指定されたPostへの明示的な返信のみを返します。例：`in_reply_to_status_id:1293593516040269825` 注記：PowerTrack および Historical PowerTrack でのみ利用可能です。
サンプル：	ルールに一致するPostのランダムサンプルを返します。サンプル割合は1〜100の整数で指定する必要があります。オペレーターが対象範囲をX%まで絞り込み、そのサンプリングされたサブセットにルール／フィルターが適用されます。例: `#happybirthday sample:5` `"happy birthday"~5 sample:80` 注記：PowerTrack および Historical PowerTrack のみで利用可能です。
source:	指定したソースアプリによって生成された任意のPostに一致します。値にはアプリ名またはアプリのURLを指定できます。例： `#happybirthday source:"X for iPhone"` `"これはテスト用のアプリ TestingApp からのテスト X です" source:MyTestAppName` ※注記：source オペレーターは Post の source 属性を検索し、単独では使用できません。
lang:	X により特定の言語に分類された Post に一致します。Post は現在、1 つの言語にのみ分類されるため、複数の言語を指定しても結果は返されません。単体での使用は推奨しません。

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


Amharic: am	German: de	Malayalam: ml	Slovak: sk
Arabic: ar	Greek: el	Maldivian: dv	Slovenian: sl
Armenian: hy	Gujarati: gu	Marathi: mr	Sorani Kurdish: ckb
Basque: eu	Haitian Creole: ht	Nepali: ne	Spanish: es
Bengali: bn	Hebrew: iw	Norwegian: no	Swedish: sv
Bosnian: bs	Hindi: hi	Oriya: or	Tagalog: tl
Bulgarian: bg	Latinized Hindi: hi-Latn	Panjabi: pa	Tamil: ta
Burmese: my	Hungarian: hu	Pashto: ps	Telugu: te
Croatian: hr	Icelandic: is	Persian: fa	Thai: th
Catalan: ca	Indonesian: in	Polish: pl	Tibetan: bo
Czech: cs	Italian: it	Portuguese: pt	Traditional Chinese: zh-TW
Danish: da	Japanese: ja	Romanian: ro	Turkish: tr
Dutch: nl	Kannada: kn	Russian: ru	Ukrainian: uk
English: en	Khmer: km	Serbian: sr	Urdu: ur
Estonian: et	Korean: ko	Simplified Chinese: zh-CN	Uyghur: ug
Finnish: fi	Lao: lo	Sindhi: sd	Vietnamese: vi
French: fr	Latvian: lv	Sinhala: si	Welsh: cy
Georgian: ka	Lithuanian: lt

例： (@XDevelopers OR to:XDevelopers) lang:es 注: 言語演算子は、X によって判定され、Post の lang 属性として設定されたその Post の特定の言語に一致します。X Entities の JSON 属性の詳細はこちらを参照してください。Post の言語を判別できない場合、当該 Post の lang は「und」（未定義）に設定されます。

オペレーター	概要
場所	指定した場所またはXのplace IDでタグ付けされたPostにマッチします。複数の語から成る地名は、引用符で囲んでください。例： `(place:London OR place:"Great Britain") -place:USA` `place:fd70c22040963ac7` 注記：をご覧くださいGET geo/searchXのplace idの取得方法については、公開APIエンドポイントを参照してください。注記：リツイートや引用ツイートには一致しません。リツイートの位置情報は元のPostに紐づいているためです。
場所_国	タグ付きの場所／ロケーションに紐づく国コードが、指定した ISO alpha-2 文字コードと一致する Post を抽出します。例： `place_country:GB OR place_country:AU OR place_country:CA` 注記：リツイートや引用ツイートにはマッチしません。リツイートの位置情報は元のPostに紐づいているためです。有効な ISO コード：ISO 3166-1 アルファ-2.
ポイント_radius:[経度緯度半径]	定義した半径内で、Post の正確な位置 (x,y) または「Place」のジオポリゴンにマッチします。 - 半径：<25mi - サポートされている単位: mi、km - 経度：±180 - 緯度: ±90° 座標は10進度で表記されています。引数は角括弧で囲み、スペースで区切ります。例: `point_radius:[-105.27346517 40.01924738 0.5mi]` 例: `point_radius:[2.355128 48.861118 16km]` 注記:リツイートや引用ツイートにはマッチしません。
境界設定_box:[west_経度南緯_緯度東経_長北_lat]	境界ボックス内に完全に収まる Exact Location または「Place」のジオポリゴンに一致します。引数は角括弧で囲み、スペースで区切ります。座標: 10進法の度（±180 経度、±90 緯度）。幅と高さは次の条件を満たす必要があります<25mi 例： `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` 注記：リツイートや引用ツイートにはマッチしません。
プロフィール_国/地域	著者のプロフィールのジオ情報にある国コードが、指定した ISO-3166-1-alpha-2 の2文字コードに一致する Post を抽出します。
プロフィール_リージョン	著者プロフィールのジオエンリッチメントに含まれる「region」フィールドで一致を判定します。完全な文字列の厳密一致です。空白や句読点を含む部分文字列には、ダブルクォートを使用してください。例: `profile_region:"ニューヨーク"`
プロフィール_地域	著者のプロフィールの地理情報拡張での「locality」フィールドに対して、文字列の完全一致でマッチします。空白や句読点を含むサブ文字列には、二重引用符を使用してください。例： `profile_locality:"サンフランシスコ"`
プロフィール_サブリージョン	作者のプロフィールのジオ拡張で得られる「subRegion」フィールドに対してマッチし、特定の郡や都市圏を含みます。完全な文字列の完全一致。例: `profile_subregion:"サンタクララ郡"`
has:geo	X の Post に含まれる、Post 固有のジオ位置データ（「geo」の緯度・経度、または表示名とジオポリゴンを持つ「Place」位置データ）に基づいてマッチします。注意:Search API では、非〜と組み合わせる必要があり、`is:`または`has:`演算子。
has:profile_geo	値に関係なく、プロフィールのGeoメタデータがあるPostに一致します。利用可能なエイリアス：`has:derived_user_geo`. 注:Search API と併用する場合、非-`is:`または`has:`演算子。
has:links	ペイロードのtextフィールド内にリンクまたは参照メディアを含むPostに一致します”テキスト”メディアや引用Tweetを含む、ペイロードのオブジェクト。注:Search API と併用する場合、非`is:`または`has:`オペレーター。
is:retweet	明示的なリツイートのみを返します。否定するとリツイートを除外し、オリジナルのコンテンツのみを返します。このオペレーターは、引用付きのTweetではなく、純粋なRetweetのみを対象とします。注意:Search API を使用する場合は、非—`is:`または`has:`演算子。
is:reply	明示的な返信のみを返します。否定すると返信を除外できます。 PowerTrack は、オリジナルの Post への返信、引用された Post 内の返信、および Retweet 内の返信に一致します。 Search API は、元のPostへの返信のみを一致対象とします。例： `@XDevelopers -is:reply`
is:quote	引用Tweet、または別のPostを参照しているPostのみを返します。引用ツイートを除外するように否定できます。例: `@XDevelopers is:quote`
is:verified	「認証済み」の投稿者によるPostのみを返します。否定することで、認証済みの投稿者によるPostを除外できます。例： `@XDevelopers is:verified`
has:mentions	別のXユーザーへの言及を含むPostに一致します。注意：Search API を使用する場合、非`is:`または`has:`オペレーター。
has:hashtags	ハッシュタグを含むPostにマッチします。注:Search API と併用する場合は、非`is:`または`has:`演算子。
has:media	X によって分類されたメディア URL（例: pic.x.com）を含む Post と一致します。利用可能な別名：`has:media_link`. 注記：Search API と併用する場合、非`is:`または`has:`演算子。
has:images	メディアのURL（例：pic.x.com）を含むPostにマッチします。注意：Search API を使用する場合は、`is:` または `has:` 以外のオペレーターと併用する必要があります`is:`または`has:`演算子。
has:videos	X にアップロードされたネイティブな X 動画を含む Post を一致対象とします。利用可能な別名：`has:video_link`。このオペレーターは、YouTube、Periscope、その他の動画ホスティングサイト上の動画にはマッチしません。注記:Search API と併用する場合は、非—`is:`または`has:`オペレーター。
has:symbols	キャッシュタグ記号（例：$TWTR）を含むPostにマッチします。注意:Search API と併用する場合、非-`is:`または`has:`演算子。

製品別オペレーター