关键字 | 独立版 | 核心 | 在 Post 正文中匹配关键词。这是基于分词的匹配，这意味着你的关键词字符串将与 Post 正文的分词文本进行比对。分词会根据标点、符号以及 Unicode 基本平面的分隔字符来拆分单词。例如，文本为“I like coca-cola”的 Post 将被拆分为以下词元：I、like、coca、cola。随后这些词元会与查询中使用的关键词字符串进行比较。要匹配包含标点（例如 coca-cola）、符号或分隔字符的字符串，必须将关键词用双引号括起来。示例：百事 OR 可口可乐 OR "coca cola" |
表情符号 | 独立版 | 核心 | 匹配 Post 正文中的表情符号。类似关键字，表情符号按分词方式匹配，也就是说，你的表情符号会与 Post 正文的分词文本进行比对。请注意，如果某个表情符号存在变体，必须将其用双引号括起来后再添加到查询中。示例：(😃 OR 😡) 😬 |
"精确短语匹配" | 独立版 | 核心 | 在 Post 的正文中匹配完全相同的短语。示例：("X API" OR #v2) -"recent counts" |
# | 独立版 | 核心 | 匹配任何包含已识别主题标签的 Post（前提是该主题标签在该 Post 中被识别为实体）。此运算符执行精确匹配，而非分词匹配，这意味着该规则#谢谢你将匹配带有精确话题标签 #thanku 的帖子，但不会匹配带有话题标签 #thankunext 的帖子。示例：#thankunext #fanart OR @arianagrande |
@ | 独立版 | 核心 | 如果给定的用户名是已识别的实体（包括 @ 字符），则会匹配任何提及该用户名的 Post。示例：(@XDevelopers OR @API) -@X |
$ | 独立版 | 高级设置 | 匹配任何包含指定“cashtag”的 Post（其标记的首字符为“”）。请注意，cashtag 运算符依赖于 X 的“symbols”实体抽取来匹配 cashtag，而不是尝试从正文中提取 cashtag。'使用 X 的“symbols”实体抽取来匹配 cashtag，而不是尝试直接从正文中提取 cashtag。示例：`twtr OR @XDevelopers -$fb` |
发件人： | 独立版 | 核心 | 匹配来自特定用户的任意 Post。取值可以是用户名（不含 @ 字符）或该用户的数字 ID。每个 from: 运算符只能传入一个用户名或 IDfrom:运算符。示例：from:XDevelopers OR from:API -from:X |
收件人： | 独立版 | 核心功能 | 匹配任何回复特定用户的 Post。取值可以是用户名（不含 @ 字符）或该用户的数字用户 ID。每个 to: 运算符只能传入一个用户名/ID收件人：运算符。示例：to:XDevelopers OR to:API -to:X |
url： | 独立版 | 核心 | 对任何格式有效的 Post URL 执行分词匹配。该运算符可匹配 url 或 expanded_url 字段的内容url或expanded_urlfields。例如，包含的某条 Post”你可以去看看 X Developer Labs：https://t.co/c0A36SWil4”（短链接会重定向到https://developer.x.com）将同时匹配以下两条规则：from:XDevelopers url:"https://developer.x.com"和from:XDevelopers url:"https://t.co". 含有标点或特殊字符的令牌和短语应使用双引号括起来。 |
retweets_of: | 独立版 | 核心 | 匹配对指定用户的帖子进行转发（Retweet）的 Post。其取值可以是用户名（不含 @ 字符）或该用户的数值型用户 ID。每个 retweets_of: 运算符只能传递一个用户名/IDretweets_of:运算符。示例：retweets_of:XDevelopers OR retweets_of:API |
context: | 独立版 | 核心 | 将包含特定域 id/实体 id 组合的 Post 进行匹配。每个 context: 运算符只能传入一个域/实体context:运算符。示例：context:domain_id.entity_id。您可以使用 OR 运算符来组合多个域/实体：(context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | 独立版 | 核心 | 匹配具有特定实体字符串值的 Post。你只能传递一个entity:运算符。示例：entity:"实体/地点的字符串声明"。请注意，此功能仅适用于“近期搜索”。 |
conversation_id: | 独立版 | 核心 | 匹配共享同一会话 ID 的 Post。会话 ID 被设置为发起该会话的 Post 的 Post ID。随着对某个 Post 的回复不断发布（包括对回复的再次回复），conversation_id会被添加到其 JSON 负载中。每个 conversation_id: 运算符一次只能传递一个会话 IDconversation_id:运算符。示例：conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | 独立版 | 高级 | 匹配指定列表成员发布的 Post。例如，如果 @XDevelopers 和 @API 是列表 123 的成员，并且你在查询中包含了list:123在你的查询中，响应将只包含由这些账号发布的 Post。你可以使用 List 查询端点来查找 List ID。示例：list:123 |
place: | 独立版 | 高级设置 | 匹配带有指定位置或 X place ID 标签的 Post。多词地名（“New York City”“Palo Alto”）应使用引号括起。每个 place: 运算符只能传入一个地点place:operator。注意：请参阅标准 v1.1 的 GET geo/search 端点，了解如何获取 X 地点 id。示例：place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | 独立版 | 高级 | 匹配与被标记的地点/位置关联的国家/地区代码等于指定 ISO Alpha-2 字母代码的 Posts。您可以在维基百科上找到有效的 ISO 代码列表。每次请求只能传递一个 ISO 代码place_country:运算符。示例：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 mi。经度范围为 ±180，纬度范围为 ±90。所有坐标均以十进制度表示。规则参数置于方括号内，使用空格分隔。示例：point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | 独立版 | 高级 | 当存在时，匹配 Post 的 place.geo.coordinates 对象；在 X 中，则匹配地点的地理多边形，且该地点多边形必须完全位于所定义区域之内。bounding_box:[west_long south_lat east_long north_lat]. 边界框的宽度和高度必须小于 25 英里。经度范围为 ±180，纬度范围为 ±90。所有坐标均为十进制度数。规则参数放在方括号内，并以空格分隔。示例：bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | 必须使用连词 | 核心功能 | 匹配与其他指定规则一致的转帖。此运算符仅查找真正的转帖（例如使用“转帖”按钮生成的内容）。引用转帖不会被此运算符匹配。示例：data @XDevelopers -is:retweet |
is:reply | 需要连词 | 核心功能 | 仅投递与某条规则精确匹配的回复。也可取反，以排除与查询匹配的回复不予投递。注意：该运算符也适用于 filtered stream 端点。与 filtered stream 搭配使用时，该运算符会匹配对原始 Post 的回复、在引用的 Posts 中的回复，以及在转发（Retweets）中的回复。示例：from:XDevelopers is:reply |
is:quote | 必须使用连词 | 核心 | 返回所有“引用 Tweet”（即带评论的 Post）。示例：“sentiment analysis” is:quote |
is:verified | 需要使用连词 | 核心 | 仅返回作者已通过 X 认证的 Post。示例：#nowplaying is:verified |
-is :nullcast | 需要使用连词 | 高级 | 移除仅在 ads.x.com 上为推广而创建且具有"source":"Twitter 广告主版（旧版）"或"source":"Twitter 广告商版"。此运算符必须加上否定。有关 Nullcasted Post 的更多信息，请参阅我们的“Post 可用性”页面。示例："mobile games" -is:nullcast |
has:hashtags | 需要使用连词 | 核心 | 匹配至少包含一个话题标签的 Post。示例：from:XDevelopers -has:hashtags |
has:cashtags | 必须使用连词 | 高级 | 匹配包含股票代码符号（以“”开头）的Post。例如，‘tag）。示例：#stonks has:cashtags` |
has:links | 需要使用连词 | 核心 | 此运算符会匹配正文中同时包含链接和媒体的 Post。示例：from:XDevelopers announcement has:links |
has:mentions | 需要使用连词 | 核心功能 | 匹配提及其他 X 用户的 Post。示例：#nowplaying has:mentions |
has:media | 必须使用连词 | 核心 | 匹配包含媒体对象（如照片、GIF 或视频）的 Post，由 X 判定。不会匹配使用 Periscope 创建的媒体，或包含指向其他媒体托管站点链接的 Post。示例：(小猫 OR 小狗) has:media |
has:images | 必须使用连词 | 核心 | 匹配包含可识别图片 URL 的 Post。示例：#meme has:images |
has:videos | 必须使用连词 | 核心 | 匹配包含原生 X 视频（直接上传到 X）的 Post。不匹配使用 Periscope 创建的视频，或包含指向其他视频托管网站链接的 Post。示例：#icebucketchallenge has:videos |
has:geo | 需要使用连词 | 高级 | 匹配包含由 X 用户提供的、Post 特定的地理定位数据的 Posts。可以是以 X place 形式提供的位置，包含对应的显示名称、地理多边形及其他字段；或者在少数情况下，是地理经纬度坐标。注意：基于地点（Post 地理）的匹配运算符只会匹配原始 Post。转发不包含任何地点数据。示例：recommend #巴黎 has:geo -bakery |
lang: | 需要使用连词 | 核心 | 匹配已被 X 归类为特定语言的 Post（且仅在该 Post 已完成语言归类时）。请注意，目前每个 Post 只会被归类为一种语言，因此将多个语言条件进行 AND 组合不会得到任何结果。每个lang:运算符。注意：如果无法确定语言分类，返回的结果为“und”（未定义）。示例：recommend #paris lang:en |
