跳转到主要内容
本页列出了在为 Filtered Stream v2 构建规则时可用的运算符。

运算符列表

注意: 某些运算符提供替代名称(别名)。
操作符类型说明
keyword独立版匹配 Post 正文中的关键词。采用基于分词的匹配方式,即将你的关键词字符串与 Post 正文的分词文本进行匹配。分词会根据标点、符号以及 Unicode 基本平面的分隔符字符来拆分词语。
例如,文本为“I like coca-cola”的 Post 会被拆分为以下词元:I、like、coca、cola。随后,这些词元将与您在规则中使用的关键字字符串进行比较。若要匹配包含标点符号(例如 coca-cola)、符号或分隔符的字符串,必须将关键字用双引号括起来。

示例:pepsi OR cola OR "coca cola"
表情符号独立版匹配 Post 正文中的表情符号。类似于关键字,表情符号采用分词匹配,这意味着你的表情符号会与 Post 正文的分词文本进行匹配。

请注意,如果某个表情符号带有变体,必须将其用双引号括起来,才能添加到规则中。

示例:(😃 OR 😡) 😬
"精确短语匹配"独立版在 Post 正文中匹配精确短语。

示例:("X API" OR #v2) -"filtered stream"
"keyword1 keyword2"~N独立版在关键词彼此相距一定范围内时匹配 Post 的近邻运算符N彼此的令牌。
反向顺序的关键词最多不能超过N−2相隔若干个 token。N不得大于6.

示例:"社交媒体"~5 OR "API"~3
#独立版如果话题标签在 Post 中被识别为实体,则匹配任何包含该已识别话题标签的 Post。

此运算符进行精确匹配,而非分词匹配,这意味着该规则#谢谢你将匹配包含精确话题标签 #thanku 的帖子,但不会匹配带有话题标签 #thankunext 的帖子。

示例:#thankunext #fanart OR @arianagrande
@独立版匹配任何提及指定用户名的 Post(前提是该用户名是已识别的实体,包含 @ 字符)。

示例:(@XDevelopers OR @api) -@x
$独立版匹配任何包含指定内容的 Post’现金符号标签’(其中令牌的首字符为“”)。<br /><br />请注意,cashtag 运算符依赖于 X&#39;s&#39;符号&#39;使用实体抽取来匹配 cashtag,而不是尝试从正文中直接抽取 cashtag。<br /><br />示例:`twtr OR @XDevelopers -$fb`
发件人:独立版匹配来自特定用户的任何 Post。
该值可以是用户名(不含“@”字符)或用户’其数值型用户 id。

您只能传递一个用户名或 idfrom:操作符。

示例:from:XDevelopers OR from:api -from:X
至:独立版匹配任何回复某特定用户的 Post。
该值可以是用户名(不含 @ 字符)或用户’其数值型用户id。

每次调用只能传递一个用户名/id收件人:操作符。

示例:to:XDevelopers OR to:api -to:x
url:独立版对任何格式有效的 Post URL 执行基于分词的匹配。

此运算符可匹配 urlexpanded_url 两个字段的内容。urlexpanded_urlfields。例如,包含”不妨看看 X Developer Labs:https://t.co/c0A36SWil4”(短链接将重定向到https://developer.x.com)将同时匹配以下两条规则:

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")。

您每次只能传递一个 URL 到url:运算符。
retweets_of:独立版可用别名: retweets_of_user:
匹配为指定用户转发(Retweet)的 Posts。该值可以是用户名(不含 @ 字符)或该用户的数字用户 ID’的数值型用户 id。

每次调用只能传入一个用户名或idretweets_of:操作符。

示例:retweets_of:XDevelopers OR retweets_of:twitterapi
请参见这里以了解查找数值型 X 账户 id 的方法。
context:独立版匹配具有特定 domain id 和/或 domain id 与 entity id 组合的 Posts,其中 * 表示通配符。要了解此运算符的更多信息,请访问我们的页面Post 标注

每个 context: 运算符只能传入一个域名/实体context:操作符。

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

示例:
context:10.799022225751871488
(domain_id.entity_id返回与该特定域—实体对匹配的 Posts

context:47.*
(domain_id.*返回与该域 id 匹配的 Posts(包含任意域-实体配对)

context:*.799022225751871488
(*.entity_id返回与该实体 id 匹配的 Post(适用于任意域-实体对)
entity:独立版匹配具有特定实体字符串值的 Post。要了解更多有关该运算符的信息,请访问我们的页面:注释

对于每个 entity: 运算符,您只能传递一个实体entity:操作符。

entity:"实体/地点的字符串声明"

示例:entity:"Michael Jordan" OR entity:"Barcelona"
conversation_id:独立版匹配具有相同会话 ID 的 Post。会话 ID 被设置为发起会话的该条 Post 的 Post ID。随着对某条 Post 的回复不断发布(包括对回复的回复),conversation_id会被添加到其 JSON 载荷中。

每个请求只能传递一个会话idconversation_id:操作符。

示例:conversation_id:1334987486343299072 (from:XDevelopers OR from:api)
简介:独立版可用别名: user_bio:
在 Post 发布者中匹配关键词或短语’的个人简介。这是在内容中的一次基于标记的匹配description在……中的字段User 对象

示例:bio:developer OR bio:"data engineer" OR bio:academic
bio_name:独立版在 Post 发布方中匹配关键词’s 用户简介名称。这是在用户内容中的分词匹配’s”名称”在该字段中User 对象

示例:bio_name:phd OR bio_name:md
bio_location:独立版可用别名: user_bio_location:
匹配由位置包含指定关键词或短语的用户发布的 Post。该运算符执行基于分词的匹配,类似于对消息正文应用的常规关键词规则。

此位置属于User 对象,在……中匹配’位置’字段,且为非规范化、用户生成的自由格式字符串。它也不同于 Post 的位置(参见 place:)。‘的位置(参见place:)。

示例:bio_location:"big apple" OR bio_location:nyc OR bio_location:manhattan
place:独立版匹配带有指定位置或 X place ID 标签的 Post。包含多个词的地点名称(“New York City”“Palo Alto”)应使用引号括起来。

你每次只能传递一个地点place:操作符。

注意:请参阅GET geo/search用于获取 X 地点 id 的标准 v1.1 端点。

注意:此运算符不会匹配转帖(Retweet),因为 Retweet’地点必须附加在原始 Post 上。它也不会匹配引用 Tweet 的原始 Post 上所附的地点。

示例:place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:独立版匹配那些其已标注地点/位置所关联的国家代码与指定 ISO alpha-2 两字符代码相同的 Post。

您可以在此找到有效的 ISO 代码列表维基百科.

每个请求只能传递一个 ISO 代码place_country:操作符。

Note: 此运算符不会匹配转推(Retweet),因为转推’s 地点附加在原始 Post 上。它也不会匹配附加在引用 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:操作符。

注意:此运算符不会匹配转推,因为转推的位置信息附加在原帖上’s 的地点附加在原始 Post 上。它也不会匹配附加在引用 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表示纬度。
- 边界框的宽度和高度必须小于 25 英里
- 经度的取值范围为 ±180
- 纬度范围为 ±90°
- 所有坐标均为十进制度。
- 规则参数置于方括号内,并以空格分隔。

每个请求只能传递一个地理多边形bounding_box:操作符。

注意:此运算符不会匹配转发,因为转发’s 的地点附加在原始 Post 上。它同样不会匹配附加在引用 Tweet 的原始 Post 上的地点。

示例:bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet必须使用连词匹配符合其余指定规则的转推。该运算符仅匹配真正的转推(例如通过“转推”按钮生成的内容)。引用推文不会被该运算符匹配。

示例:data @XDevelopers -is:retweet
is:reply需要使用连词仅投递与某条规则匹配的明确回复。也可通过取反来排除匹配该规则的回复,使其不被投递。

与 filtered stream 搭配使用时,此运算符会匹配对原始 Post 的回复、在被引用的 Post 中的回复,以及在 Retweet 中的回复。

示例:from:XDevelopers is:reply
is:quote需要使用连词返回所有 Quote Tweets,也就是带评论的 Posts。

示例:“情感分析” is:quote
is:verified需要使用连词仅投递作者已通过 X 认证的 Posts。

示例:#nowplaying is:verified
-is:nullcast需要使用连词移除仅在 ads.twitter.com 上为投放推广而创建的 Post,且这些 Post 具有source:"Twitter 广告主版(旧版)"source:"Twitter 广告主版".
必须对该运算符取反。

如需了解有关 Nullcasted Post 的更多信息,请参阅我们的页面Post 可用性

示例:"移动游戏" -is:nullcast
has:hashtags需要使用连词匹配包含至少一个话题标签的 Post。

示例:from:XDevelopers -has:hashtags
has:cashtags需要使用连词匹配包含现金标签符号的 Post(以“”为前缀,例如“”为前缀,例如“tag”)‘&#39;字符。例如:`tag)。<br /><br />示例:#stonks has:cashtags`
has:links需要使用连词此运算符会匹配正文中包含链接和媒体的 Post。

示例:from:XDevelopers announcement has:links
has:mentions需要使用连词匹配提及其他 X 用户的帖子。

示例:#nowplaying has:mentions
has:media需要使用连词可用别名: has:media_link
匹配由 X 判定为包含媒体对象(如照片、GIF 或视频)的 Post。不匹配使用 Periscope 创建的媒体,或包含指向其他媒体托管网站链接的 Post。

示例:(小猫 OR 小狗) 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 的 Posts。位置可以是以 X place 形式提供,包含相应的显示名称、地理多边形及其他 fields;在少数情况下,也可能是一个地理经纬度坐标。

注意:基于地点(Post 地理信息)进行匹配的运算符仅会匹配原始 Post。转发不包含任何地点数据。

示例:recommend #paris has:geo -bakery
sample:必须使用连词返回符合某项规则的 Posts 的随机百分比样本,而非全部 Posts 集合。百分比值必须用 1 到 100 的整数表示(例如,sample:10将返回随机的 10% 样本)。

该运算符会先将流按你指定的百分比进行抽样,然后再将规则/过滤器应用于该抽样子集。换言之,例如当你使用时,sample:10,每条 Post 有 10% 的概率被纳入样本。

此运算符适用于整条规则,并要求所有 OR 条件同时满足’将使用 OR 连接的术语进行分组。

示例:#正在播放 @spotify sample:15
lang:需要使用连词匹配被 X 归类为特定语言的 Post(且仅在该 Post 已被归类的情况下)。请注意,目前每个 Post 仅会被归为一种语言,因此将多种语言以 AND 组合不会返回任何结果。

每个请求只能传递一个 BCP 47 语言标识符lang:操作员。

Note: 如果无法进行语言分类,提供的结果为 ‘und’(未定义)。‘and’(针对 undefined)。

示例: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
德文德语
希腊语el
古吉拉特语gu
海地克里奥尔文ht
希伯来文iw
印地语你好
拉丁化的印地语hi-Latn
匈牙利语匈牙利语
冰岛语is
印尼文
意大利语it
日语ja
卡纳达语kn
高棉语公里
韩文ko
老挝语lo
拉脱维亚语lv
立陶宛语lt
马拉雅拉姆语ml
迪维希语dv
马拉地语mr
尼泊尔语ne
挪威语
奥里亚语
旁遮普语pa
普什图语ps
波斯语fa
波兰语pl
葡萄牙语pt
罗马尼亚语ro
俄文俄语
塞尔维亚语sr
简体中文简体中文(中国)
信德语sd
僧伽罗语si
斯洛伐克语sk
斯洛文尼亚语sl
索拉尼库尔德语ckb
西班牙文es
瑞典语sv
塔加洛语tl
泰米尔语ta
泰卢固语te
泰文th
藏文bo
繁體中文zh-TW
土耳其语tr
乌克兰语英国
乌尔都语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:
当作者的关注数(其关注的用户数量)处于指定范围内时匹配 Posts。
如果仅指定一个数字,则会匹配所有大于或等于该数字的数值。

示例:following_count:500

此外,可以指定一个范围来匹配该范围内的任意数值。

示例:following_count:1000..10000
listed_count:可用别名: user_in_lists_count:
当作者被纳入指定数量的 Lists 时,匹配相应的 Posts。
如果仅指定一个数字,则会匹配任何大于或等于该数字的值。

示例: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:匹配由指定来源 App 生成的任何 Post。该值必须是该 App 的名称或该 App 的 URL。‘的 URL。不能单独使用。

示例:source:"iPhone 版 X"

注意:作为 X App 开发者,你的应用通过编程方式创建的 Post,其“来源”将显示为你的应用名称和网站 URL。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 的显式(或原生)转发。请注意,所使用的 status id 应为原始 Post 的 id,而不是转发的 id。

示例:retweets_of_tweet_id:1539382664746020864