运算符列表
注意： 某些运算符提供了替代名称（别名）。
| 操作符 | 类型 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword | 独立版 | 在 Post 正文中匹配关键字。这是基于分词的匹配，表示你的关键字字符串将与 Post 正文的分词文本进行比对。分词会依据标点、符号以及 Unicode 基本平面中的分隔符字符来切分词语。 例如，文本为“I like coca-cola”的 Post 会被拆分成以下标记：I、like、coca、cola。随后，这些标记会与查询中使用的关键字字符串进行比较。要匹配包含标点符号（例如 coca-cola）、符号或分隔符字符的字符串，必须将关键字用双引号括起来。 示例： pepsi OR cola OR "coca cola" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
emoji | 独立版 | 在 Post 正文中匹配表情符号。与关键词类似，表情符号采用基于词元的匹配方式，这意味着你的表情符号会与 Post 正文的分词文本进行匹配。 请注意，如果某个表情符号存在变体，必须将其用双引号括起来，才能将其添加到查询中。 示例： (😃 或 😡) 😬 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
"精确短语匹配" | 独立版 | 匹配 Post 正文中的精确短语。 示例： ("X API" OR #v2) -"recent search" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
# | 独立版 | 如果某个话题标签在 Post 中被识别为实体，则匹配任何包含该已识别话题标签的 Post。 此运算符执行精确匹配，而不是分词匹配，这意味着该规则 #谢谢你将匹配带有精确话题标签 #thanku 的 Post，但不匹配带有话题标签 #thankunext 的 Post。示例： #thankunext #fanart OR @arianagrande | ||||||||||||||||||||||||||||||||||||||||||||||||||||
@ | 独立版 | 匹配任何提及指定用户名的 Post（前提是该用户名为可识别实体，包含 @ 字符）。 示例： (@XDevelopers OR @API) -@X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
$ | 独立版 | 匹配任何包含指定内容的 Post’现金标签’（其中标记的首字符为“”）。<br /><br />请注意，cashtag 运算符依赖于 X's'符号'使用实体抽取来匹配 cashtag，而不是尝试直接从正文中提取 cashtag。<br /><br />示例：`twtr OR @XDevelopers -$fb` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
from: | 独立版 | 匹配来自特定用户的任意 Post。 该值可以是用户名（不包含 @ 字符）或该用户的数字 id。 每次调用只能传入一个用户名或ID 发件人：操作符。示例： from:XDevelopers OR from:API -from:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
收件人： | 独立版 | 匹配任何回复特定用户的 Post。 该值可以是用户名（不含“@”字符）或该用户的数字用户id。 每次调用只能传入一个用户名或 id 收件人：操作符。示例： to:XDevelopers OR to:API -to:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
url: | 独立版 | 对任何格式正确的 Post URL 执行基于分词的匹配。 此运算符会匹配 url 和 expanded_url 两个字段的内容URL或expanded_urlfields。例如，一个包含”你可以了解一下 X Developer Labs：https://t.co/c0A36SWil4”（其中短链接将重定向至https://developer.twitter.com）将同时匹配以下两条规则：from:XDevelopers url:"https://developer.twitter.com"（因为它将匹配以下内容）entities.urls.expanded_url)from:XDevelopers url:"https://t.co"（因为它将与……的内容匹配entities.urls.url)包含标点或特殊字符的标记和短语应使用双引号括起（例如， url:"/developer")。同样地，如需匹配特定协议，请用双引号将其括起（例如，url:"https://developer.twitter.com")。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of: | 独立版 | 匹配为指定用户所转发（Retweet）的 Post。该值可以是用户名（不包含 @ 字符）或该用户的数字用户 ID。 每个 retweets_of: 运算符只能传入一个用户名/idretweets_of:操作符。示例： retweets_of:twitterdev OR retweets_of:twitterapi | ||||||||||||||||||||||||||||||||||||||||||||||||||||
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 的显式（或原生）转发。请注意，所用的 Post ID 应为原始 Post 的 ID，而非转发的 ID。 示例： retweets_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
quotes_of_tweet_id: | 独立版 | 可用别名： quotes_of_status_id:匹配指定 Post 的引用 Tweet。请注意，所使用的 Post ID 应为原始 Post 的 ID，而非某条引用 Tweet 的 ID。 示例： quotes_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
context: | 独立版 | 匹配具有特定域 id/实体 id 对的 Post。要了解更多关于此运算符的信息，请访问我们关于标注。 每个请求只能传入一个域名/实体 context:操作符。context:domain_id.entity_id不过，你可以使用 OR 运算符来组合多个域名/实体： (context:47.1139229372198469633 OR context:11.1088514520308342784)示例： context:10.799022225751871488(domain_id.entity_id返回与该特定域—实体对匹配的 Posts) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
entity: | 独立版 | 匹配具有特定实体字符串值的 Post。若想进一步了解该运算符，请访问我们的页面Post 注解。 请注意此功能仅适用于 Recent search。 只能传入一个 entity:操作符。entity:"实体/地点的字符串声明"示例： entity:"Michael Jordan" OR entity:"Barcelona" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
conversation_id: | 独立版 | 匹配共享同一会话 ID 的 Post。会话 ID 会被设置为发起该会话的 Post 的 Post ID。随着对某个 Post 的回复不断发布（包括对回复的回复），conversation_id将被添加到其 JSON 载荷中。每个请求只能传递一个会话id conversation_id:操作符。示例： conversation_id:1334987486343299072 (from:XDevelopers OR from:api) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
list: | 独立版 | 匹配由指定列表的成员用户发布的 Post。 例如，若 @XDevelopers 和 @api 是列表 123 的成员，且你包含了 list:123在你的查询中，响应将只包含这些账户发布的 Post。你可以通过使用列表查找终端节点。请注意你只能使用单个 list:每个查询只能使用一个运算符，而且每个list:操作符。示例： list:123 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place: | 独立版 | 匹配带有指定位置或 X 地点 ID 标签的 Post。多词地点名称（“New York City”“Palo Alto”）应加引号括起。 每个 place: 运算符只能传入一个位置place:操作符。注意：请参见GET geo/search用于获取 X 地点 id 的标准 v1.1 端点。 注意：此运算符不会匹配转推，因为转推’s 的地点附加在原始 Post 上。它同样不会匹配附加在引用型 Tweet 的原始 Post 上的地点。 示例： place:"new york city" OR place:seattle OR place:fd70c22040963ac7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place_country: | 独立版 | 匹配那些带有已标记地点/位置的 Posts，其关联的国家代码与指定的 ISO alpha-2 字符代码一致。 您可以在此处找到有效的 ISO 代码列表维基百科。 您每次只能传递一个 ISO 代码 place_country:操作符。Note: 此运算符不会匹配转推，因为转推的地点附加在原始推文上’此运算符不会匹配转帖（Retweet），因为转帖的地点附加在原始 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表示纬度。- east_long north_lat表示边界框的东北角，且east_long为该点的经度，且north_lat是纬度。- 边界框的宽度和高度必须小于 25 英里 - 经度范围为 ±180° - 纬度范围为 ±90° - 所有坐标均采用十进制度数表示。 - 规则参数置于方括号内，使用空格分隔。 每次调用只能传入一个地理多边形 bounding_box:操作符。注意：此运算符不会匹配转推，因为转推’所附地点属于原始 Post。它也不会匹配附加在引用 Tweet 的原始 Post 上的地点。 示例： bounding_box:[-105.301758 39.964069 -105.178505 40.09455] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_likes | 独立版 | 匹配点赞数至少达到指定数量的 Post。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_replies | 独立版 | 匹配至少拥有指定回复数的 Post。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_reposts | 独立版 | 匹配转发数至少达到指定值的 Post。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:retweet | 必须使用连词 | 匹配符合其余指定规则的转发（Retweet）。此运算符仅匹配真正的转发（例如通过 Retweet 按钮生成的）。引用推文（Quote Tweet）不会被此运算符匹配。 示例： data @XDevelopers -is:retweet | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:reply | 需要使用连词 | 仅投递与某条规则匹配的明确回复。也可取反，以排除与某个查询匹配的回复不予投递。 注意：该运算符同样适用于 filtered stream 端点。与 filtered stream 搭配使用时，它可匹配对原始 Post 的回复、引用的 Tweet 中的回复，以及转发（Retweet）中的回复。 示例： from:XDevelopers is:reply | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:quote | 必须使用连词 | 返回所有引用 Tweet，也称为带评论的 Post。 示例： “情感分析” is:quote | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:verified | 需要使用连词 | 仅投递作者经 X 验证的 Post。 示例： #nowplaying is:verified | ||||||||||||||||||||||||||||||||||||||||||||||||||||
-is:nullcast | 必须使用连词 | 移除仅在 ads.twitter.com 上为推广而创建且具有"source":"Twitter 广告主（旧版）"或"source":"Twitter 广告主版"。此运算符必须被取反。 如需了解 Nullcasted Posts 的更多信息，请参阅我们的页面：Post 可用性。 示例： "mobile games" -is:nullcast | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:hashtags | 需要使用连词 | 匹配包含至少一个话题标签的 Post。 示例： from:XDevelopers -has:hashtags | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:cashtags | 需要使用连接词 | 匹配包含 cashtag 符号（以“tag).<br /><br />示例：#stonks has:cashtags` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:links | 必须使用连词 | 此运算符用于匹配在 Post 正文中包含链接和媒体的 Post。 示例： from:XDevelopers announcement has:links | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:mentions | 需要使用连词 | 匹配提及其他 X 用户的 Post。 示例： #nowplaying has:mentions | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:media | 需要使用连接词 | 可用别名： has:media_link匹配包含媒体对象的 Posts（由 X 判定），例如照片、GIF 或视频。不匹配使用 Periscope 创建的媒体，或包含指向其他媒体托管网站链接的 Posts。 示例： (kittens OR puppies) has:media | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:images | 需要连词 | 匹配包含可识别图片 URL 的 Posts。 示例： #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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
lang: | 需要使用连词 | 匹配被 X 归类为特定语言的 Post（且仅当该 Post 已被归类时）。需要注意的是，目前每个 Post 只会被归类为一种语言，因此对多种语言进行 AND 组合将不会返回任何结果’将多种语言使用 AND 组合将不会返回任何结果。 每个…只能传入一个 BCP 47 语言标识符 lang:操作符。注意：如果无法确定语言分类，返回的结果为“und”（未定义）。 示例： recommend #paris lang:en以下列表列出了当前支持的语言及其对应的 BCP 47 语言标识符： 阿姆哈拉语： am | 德文：德语 | 马拉雅拉姆语：ml | 斯洛伐克语：sk阿拉伯语： ar | 希腊文：el | 马尔代夫语：dv | 斯洛文尼亚语：sl亚美尼亚语： hy | 古吉拉特语：gu | 马拉地语：mr | 索拉尼库尔德语：ckb巴斯克语： eu | 海地克里奥尔文：ht | 尼泊尔语：ne | 西班牙语：es孟加拉语： bn | 希伯来文：iw | 挪威语：否 | 瑞典语：sv波斯尼亚语： bs | 印地语：你好 | 奥里亚语：或 | 塔加洛语：tl保加利亚语： bg | 拉丁化的印地语：印地语（拉丁字母）（hi-Latn） | 旁遮普语：pa | 泰米尔语：ta缅文： my | 匈牙利语：hu | 普什图语：ps | 泰卢固语：te克罗地亚语： hr | 冰岛语：is | 波斯语：fa | 泰文：th加泰罗尼亚语： ca | 印度尼西亚语：in | 波兰语：pl | 藏语：bo捷克语： cs | 意大利语：it | 葡萄牙语：pt | 繁體中文：zh-Hant-TW丹麦语： da | 日文：ja | 罗马尼亚语：ro | 土耳其语：tr荷兰语： nl | 卡纳达语：kn | 俄文：ru | 乌克兰语：英国英语： 英语 | 柬埔寨语：km | 塞尔维亚文：sr | 乌尔都语：ur爱沙尼亚语： ET | 韩文：ko | 简体中文：中文（简体，zh-CN） | 维吾尔语：ug芬兰语： fi | 老挝文：lo | 信德语：sd | 越南语：vi法语： fr | 拉脱维亚语：lv | 僧伽罗语：si | 威尔士文：cy格鲁吉亚语： ka | 立陶宛语：lt |