query 字段，也可用于 x.com。少数标注为仅界面可用的运算符依赖登录账号的信息，例如关注对象、所在地和社交网络，因此不能通过 API 使用。
注意： 如需可直接复制的查询方案、包含分页的 Python/JavaScript 生产代码，以及与官方 X API v2 运算符的并排比较，请参阅博客上的 Twitter 搜索运算符完整速查表。
基础语法
- 词语之间的空格表示隐式 AND
OR必须大写- 在前面加减号（
-）可排除词语、短语或运算符条件 - 使用括号对表达式分组
- 使用双引号包围精确短语
cat OR black dog 会按 cat OR (black dog) 处理。请用括号消除歧义。
免费可视化查询构建器
不想手动组合运算符字符串时，可以使用 Sorsa 搜索构建器。这是无需登录的免费图形工具，可切换筛选条件并预览生成的查询字符串，再将它集成到代码中。1. 关键词与布尔逻辑
单复数形式会相互匹配。运算符会匹配推文正文、作者显示名称、用户名以及推文中展开后的 URL。
2. 用户与账号筛选
3. 互动门槛
数值很大时（1,000 以上），计数会变为近似值。
4. 媒体与内容类型
媒体筛选
推文类型筛选
特殊内容筛选
5. 日期、时间与 Snowflake ID
Snowflake ID 转换。 每条推文 ID 都编码了创建时间戳：
6. 地理位置筛选
据估计，只有 1%–2% 的推文带有精确地理位置数据。如果推文没有坐标，API 会退而使用用户资料中的所在地进行反向地理编码。
7. 语言与来源
语言
支持标准 ISO 639-1 代码（lang:en、lang:es、lang:fr、lang:de、lang:ja、lang:ru 等），以及以下 X 专用代码：
来源（发帖客户端）
常见值：
Twitter_for_iPhone、Twitter_for_Android、Twitter_Web_App、TweetDeck、twitter_ads。
8. 卡片与 URL 运算符
card_name: 通常只匹配最近 7–8 天的推文。
构建查询
建议按以下顺序组合查询，便于扩展：- 组合核心关键词：
(bitcoin OR ethereum OR $BTC) - 添加内容条件：
lang:en、filter:images、-filter:replies - 设置互动门槛：
min_faves:50、min_retweets:10 - 排除噪声：
-from:spambot、-scam、-filter:retweets - 添加时间范围：
since:2026-01-01 until:2026-03-01
已知限制
- 运算符数量上限： 每个查询约 22–23 个。
- 地理数据覆盖有限： 仅 1%–2% 的推文有精确位置。
card_name:有时间限制： 仅最近 7–8 天。- 私有和被停用账号不会出现在搜索结果中。
- 对短推文、代码或大量表情符号的帖子，语言检测并不完美。
- 并非所有推文都被索引。 被标记违反平台规则的推文可能被排除。
- 某些情况下会发生静默自动纠错。使用
+word或"word"强制精确匹配。 - URL 匹配适用于域名和子域名，但对较长 URL 路径不可靠。