规则与筛选：企业版

企业版规则与查询入门

使用企业版运算符的产品会根据你设置的筛选规则向你提供社交数据。规则由一个或多个“子句”组成，子句可以是关键词、精确短语，或任一企业版运算符。在开始使用企业版运算符构建规则之前，请务必查看下文所述语法、浏览可用运算符列表，并了解构建规则的相关限制。你还应理解规则在逻辑层面的评估细节，详见“运算顺序”部分。多个子句可同时通过 “and” 与 “or” 逻辑进行组合。 请注意： “and” 逻辑通过子句之间的空格表示，而 “or” 逻辑通过大写的 OR 表示。每条规则最长 2,048 个字符，对正向子句（希望匹配或筛选的内容）和负向子句（希望排除且不匹配的内容）的数量不设上限。

构建规则与查询

关键词匹配 关键词匹配类似于搜索界面中的查询。例如，以下企业版运算符规则将匹配正文中包含“social”一词的活动。 social 用空格实现 AND 逻辑 添加另一个关键词等同于增加一条匹配条件。例如，此规则仅匹配文本中同时出现“social”和“media”的活动，顺序不限——在术语之间留一个空格即表示布尔 AND 逻辑。如果在规则中显式写 AND，规则端点会拒绝该规则。 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:XDeveloeprs 距离美国科罗拉多州博尔德市 Pearl St. 方圆 10 英里内、带地理标签的 Tweet 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	在两个运算符之间留空格，即表示它们之间为 AND 逻辑。匹配同时包含两个关键词（“social”、“data”）的活动。不要在规则中显式使用 AND。只使用空格。显式写出的 AND 会被当作普通关键词处理。
OR	social OR data	要将两个运算符进行 OR 连接，请在它们之间插入用空格分隔的全大写 OR。匹配包含任一关键词（“social” 或 “data”）的活动。注意，如果你在单条规则中同时使用 OR 和 AND，请先理解“运算顺序”一节所述的优先级，并按下文所述使用括号将非取反的运算符分组，以确保规则按预期工作。你必须在规则中使用大写的 “OR”；小写的 ‘or’ 会被视为普通关键词。
NOT	social data -apple -android -phone	在运算符或一组运算符前紧接着插入 `-` 字符。上述示例规则匹配包含关键词 “social” 的活动，但排除包含关键词 “data” 的活动。不允许使用会请求“firehose 中除取反项以外的全部内容”的取反 OR。例如，`apple OR -ipad` 无效，因为它会匹配除提到 “ipad” 之外的所有活动。
分组	(social OR data) -XDeveloeprs -api	使用括号包裹多个运算符可创建一个功能性“分组”。分组可像单个子句一样，通过空格（AND）或 OR 与其他子句连接。不过，最佳实践是不对整个分组统一取反（即不对整组加 -）。相反，应分别对每个运算符取反，并用空格（AND）串联。例如，不要使用 -(iphone OR imac OR macbook)，而应使用：-iphone -imac -macbook。当单条规则同时包含 AND 和 OR 时，分组尤为重要，因为规则按特定的运算顺序进行评估。详见下文。

请注意： 运算符可以为正或为负。 正向运算符 定义你希望在结果中包含的内容。例如，has:hashtags 运算符表示“我希望包含带有话题标签的活动”。 负向运算符 定义你希望从结果中排除的内容，通过上述布尔 NOT 逻辑实现。例如，-has:hashtags 表示“排除任何包含话题标签的活动，即使它们在其他方面符合我的规则”。高级运算符产品对正向和负向子句的数量不设限制，但规则长度最多为 2,048 个字符。

运算顺序

当在单个规则中同时使用 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”。带有重音或变音符号的字符与普通字符同等对待，不视为词边界。例如，规则 cumpleaños 只会匹配包含单词 cumpleaños 的活动，不会匹配包含 cumplea、cumplean 或 os 的活动。所有运算符的评估均不区分大小写。例如，规则 Cat 将匹配以下所有内容：“cat”、“CAT”、“Cat”。

PowerTrack 规则标签

如我们在“匹配规则”页面所述，每条规则都可以带有一个标签。标签本身不会影响过滤，但可用于在你的应用中对规则进行逻辑分组。每条规则只能有一个标签，且长度最多为 255 个字符。按照“匹配规则”页面的说明，通过 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"}]}

匹配引用 Tweet 的运算符

在使用 PowerTrack API 和 Historical PowerTrack API 时，以下运算符将同时匹配被引用的原始 Post 的内容以及新的引用 Tweet 的内容。但是，如果你使用的是 Search API，这些运算符将只匹配引用 Tweet 的内容，而不会匹配被引用的原始 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 天与完整归档搜索 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 个 token 的 Post 的近邻运算符。按相反顺序出现的关键词之间的间隔不得超过 N-2 个 token。N 不得大于 6。示例：`"social media"~5 OR "API"~3`
包含：	对正文中包含指定子串的 Posts 进行子串匹配，不受分词影响。对包含空格或标点符号的子字符串请使用双引号。示例：`(contains:social OR contains:"wikipedia.com") -contains:"buy now"`
发件人：	匹配来自特定用户的任何 Post，可通过 X 数字账户 ID 或用户名进行匹配（不包括`@`)。示例：`(from:2244994945 OR from:api OR from:twittereng) -from:jack`
收件人：	匹配任何回复特定用户的 Post，可按 X 数字 Account ID 或用户名匹配（不包含`@`）。示例：`(to:2244994945 OR to:api OR to:twittereng) -to:jack`
url：	对 Post 的展开 URL 执行基于分词的（关键词/短语）匹配。示例：`@XDevelopers url:"developer.x.com"`
URL_标题：	对展开后的 URL 的 HTML 标题元数据执行关键词/短语匹配。仅适用于 PowerTrack 与 Historical PowerTrack。
URL_description:	在扩展的页面描述元数据中执行关键字/短语匹配。仅在 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。
简介_名称：	匹配 Post 的用户个人资料名称中的关键词。这是在用户“name”字段内进行的分词匹配。注意：仅适用于 PowerTrack 和 Historical PowerTrack。用户对象。注：仅在 PowerTrack 和 Historical PowerTrack 中可用。
个人简介_位置：	匹配其用户对象为……的帖子’的位置包含指定的关键字或短语。此运算符执行基于分词的匹配，类似于应用于消息正文的常规关键字规则。此位置是……的一部分User 对象，并且是该账号’s’首页’位置。注意：仅适用于 PowerTrack 与 Historical PowerTrack。
状态集_计数	当作者在指定范围内发布的状态数符合条件时，匹配 Post。如果仅指定一个数字，则会匹配任何大于或等于该数字的数值。可以指定一个范围以匹配该范围内的任意数字（例如，`statuses_count:1000..10000`)。示例： `to:api statuses_count:10` 注意：仅适用于 PowerTrack 与 Historical PowerTrack。
粉丝_count:	当作者的关注数处于指定范围时匹配 Posts。如果指定单个数字，将匹配任何大于或等于该数字的值。可以指定一个范围来匹配该范围内的任意数字（例如，`followers_count:1000..10000`）。注意：仅在 PowerTrack 和 Historical PowerTrack 中可用。
好友_计数：	当作者的关注数（其关注的用户数量）在指定范围内时，匹配 Posts。如果只指定一个数字，则任何大于或等于该数字的数值都会匹配。可以指定一个范围来匹配该范围内的任意数值（例如，`friends_count:1000..10000`）。注意：仅适用于 PowerTrack 和 Historical PowerTrack。
已列出_计数：	当作者在 X 上被加入列表的次数处于指定范围内时，匹配 Posts。如果只指定一个数字，则会匹配任何大于或等于该数字的数值。可以指定一个范围来匹配该范围内的任意数字（例如，`listed_count:10..100`）。注意：仅适用于 PowerTrack 和 Historical PowerTrack。
$	匹配任何包含指定“cashtag”实体的 Post。示例：`($TWTR OR $TSLA OR $BRK.A) -$F` 注意：“cashtag” 运算符依赖 X’使用 X 的“symbols”实体提取来匹配 cashtag，而不是直接从正文中提取。
转推_“of:”	匹配对指定用户的 Post 进行转发的内容。同时支持用户名和数字形式的 X 账号 id（不是 Post 状态 id）。示例：`(retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack`
转推_的_状态_id:	仅返回指定 Post 的显式转发。请使用原始 Post 的 id，而非某个转发的 id。示例：`retweets_of_status_id:1293593516040269825` 注：仅限 PowerTrack 和 Historical PowerTrack 使用。
于_回复_至_状态_id：	仅投递对指定 Post 的直接回复。示例仅传递对指定 Post 的直接回复。示例：`in_reply_to_status_id:1293593516040269825` 注意：仅适用于 PowerTrack 和 Historical PowerTrack。`in_reply_to_status_id:1293593516040269825` 注意：仅适用于 PowerTrack 与 Historical PowerTrack。
示例：	返回与某条规则匹配的 Post 的随机样本。样本比例必须是 1 到 100 之间的整数。运算符将范围缩减至 X%，然后把规则/过滤器应用到该抽样子集。示例： `#happybirthday sample:5` `"生日快乐"~5 sample:80` 注意：仅适用于 PowerTrack 和 Historical PowerTrack。
来源：	匹配由指定源应用生成的任何 Post。该值可以是应用名称或该应用的 URL。示例： `#happybirthday source:"适用于 iPhone 的 X"` `"这是一条来自我的 TestingApp 的测试 X" source:MyTestAppName` 注：source 运算符会基于 Post 的 source 属性进行搜索，且不能单独使用。
lang:	匹配被 X 归类为特定语言的 Post。当前每条 Post 仅被归类为一种语言，因此同时匹配多种语言将不会返回结果。不建议单独使用。

下表列出了当前支持的语言及其对应的 BCP 47 语言标识符：


阿姆哈拉语: am	德语: de	马拉雅拉姆语: ml	斯洛伐克语: sk
阿拉伯语: ar	希腊语: el	迪维希语: dv	斯洛文尼亚语: sl
亚美尼亚语: hy	古吉拉特语: gu	马拉地语: mr	索拉尼库尔德语: ckb
巴斯克语: eu	海地克里奥尔语: ht	尼泊尔语: ne	西班牙语: es
孟加拉语: bn	希伯来语: iw	挪威语: no	瑞典语: sv
波斯尼亚语: bs	印地语: hi	奥里亚语: or	他加禄语: tl
保加利亚语: bg	拉丁化印地语: hi-Latn	旁遮普语: pa	泰米尔语: ta
缅甸语: my	匈牙利语: hu	普什图语: ps	泰卢固语: te
克罗地亚语: hr	冰岛语: is	波斯语: fa	泰语: th
加泰罗尼亚语: ca	印度尼西亚语: in	波兰语: pl	藏语: bo
捷克语: cs	意大利语: it	葡萄牙语: pt	繁体中文: zh-TW
丹麦语: da	日语: ja	罗马尼亚语: ro	土耳其语: tr
荷兰语: nl	卡纳达语: kn	俄语: ru	乌克兰语: uk
英语: en	高棉语: km	塞尔维亚语: sr	乌尔都语: ur
爱沙尼亚语: et	韩语: ko	简体中文: zh-CN	维吾尔语: ug
芬兰语: fi	老挝语: lo	信德语: sd	越南语: vi
法语: fr	拉脱维亚语: lv	僧伽罗语: si	威尔士语: cy
格鲁吉亚语: ka	立陶宛语: lt

示例： (@XDevelopers OR to:XDevelopers) lang:es 注意：语言运算符将基于由 X 判定并设置为 Post 的 lang 属性的特定语言进行匹配。有关 X 实体 JSON 属性的更多信息，请参见此处。如果某条 Post 无法进行语言分类，其 lang 将被设为“und”（未定义）。

操作符	说明
位置	匹配带有指定位置或 X 地点 ID 标签的 Post。包含多个词的地名应加引号。示例： `(place:London OR place:"Great Britain") -place:USA` `place:fd70c22040963ac7` 注意：请参阅GET geo/search用于获取 X 地点 id 的公共 API 端点。注意：不会匹配转发（Retweet）或引用转发（Quote Tweet），因为转发的位置信息附加在原始 Post 上。
位置_国家/地区	匹配带有已标记地点/位置且其关联的国家/地区代码与给定 ISO alpha-2 字符代码相符的 Posts。示例： `place_country:GB OR place_country:AU OR place_country:CA` 注意不会匹配转推（Retweet）或引用推文（Quote Tweet），因为转推的位置信息附加在原始 Post 上。有效的 ISO 代码：ISO 3166-1 双字母代码。
要点_radius:[经度纬度半径]	在定义的半径内，匹配 Post 的精确位置 (x,y) 或“Place”地理多边形。 - 半径：<25 英里 - 支持的单位：英里（mi）、千米（km） - 经度：±180 - 纬度：±90° 坐标以十进制度表示。参数用方括号括起，使用空格分隔。示例： `point_radius:[-105.27346517 40.01924738 0.5mi]` 示例： `point_radius:[2.355128 48.861118 16千米]` 注意：不适用于转推或引用推文。
界定_box:[west_经度南_纬度东向_长北_lat]	匹配边界框内的精确位置，或边界框中完全包含的“Place”地理多边形。参数用方括号括起，以空格分隔。坐标：十进制度（经度 ±180，纬度 ±90）。必须设置宽度和高度<25 英里示例： `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` 注意不会匹配转推（Retweets）或引用推文（Quote Tweets）。
个人资料_国家	匹配作者个人资料地理位置的国家代码与指定 ISO‑3166‑1‑alpha‑2 两字母代码相同的 Posts。
个人资料_区域	对作者资料的地理信息增强中“region”字段进行匹配，要求精确的全字符串匹配。对包含空白或标点符号的子字符串使用双引号。示例： `profile_region:"New York"`
个人资料_所在地	对作者资料的地理信息扩充中的“locality”字段进行匹配，需为精确的全字符串匹配。对于包含空白字符或标点的子字符串，请使用双引号。示例： `profile_locality:"旧金山"`
个人资料_子区域	匹配作者个人资料地理增强中的“subRegion”字段，包括特定县或都会区。完整字符串的精确匹配。示例： `profile_subregion:"圣克拉拉县"`
has:geo	将来自 X 的 Posts 与其特定的地理位置信息进行匹配，包括 “geo” 经纬度，或带有显示名称与地理多边形的 “Place” 位置数据。注意：使用 Search API 时，必须与非—`is:`或`has:`操作符。
has:profile_地理位置	匹配包含任意 Profile Geo 元数据的 Post，不论具体值为何。可用别名：`has:derived_user_geo`。注意：使用 Search API 时，必须与非`is:`或`has:`操作符。
has:links	匹配在有效负载的 text 对象中包含链接或被引用媒体的 Post，包括媒体与引用 Post（Quote Tweets）。“文本”有效负载中的对象，包括媒体和引用的 Tweet。注意：使用 Search API 时，必须与非 —`is:`或`has:`运算符。
is:retweet	仅返回明确的转推。可取反以排除转推，仅返回原始内容。此运算符仅匹配真正的转发（Retweets），不包含引用推文（Quoted Tweets）。注意：使用 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 的 Posts（例如：pic.x.com）。可用别名：`has:media_link`。注意：使用 Search API 时，必须与非—`is:`或`has:`操作符。
has:images	匹配包含媒体 URL（例如 pic.x.com）的 Post。注意：使用 Search API 时，必须与非—`is:`或`has:`操作符。
has:videos	匹配包含在 X 上上传的原生 X 视频的 Post。可用别名：`has:video_link`. 此运算符不会匹配来自 YouTube、Periscope 或其他视频托管网站的视频。注意：与 Search API 搭配使用时，必须与非`is:`或`has:`运算符。
has:symbols	匹配包含股票代号符号的 Post（例如 $TWTR）。注意：使用 Search API 时，必须与非—`is:`或`has:`操作符。

按产品分类的运算符