X（推特）的高级搜索语法能通过 API 用吗？

比如你想找上周提到某个产品的日语帖子，要求点赞过百、排除回复。在 X 搜索框里一行就够："claude code" lang:ja since:2026-11-05 min_faves:100 -filter:replies。把这一行原样作为 X 帖子搜索的 query 传进去就行。查询会按原样交给 X 的搜索，网页上搜得到的，接口里也搜得到。

最常用的语法

语法	示例	作用
from: / to:	from:openai、to:openai	某账号发的帖子，或回复某账号的帖子
"..."	"open source"	精确短语
OR、-	rag OR retrieval -job	任一关键词，排除某个词
lang:	lang:zh	限定语言
since: / until:	since:2026-10-01 until:2026-11-01	时间范围
min_faves: / min_retweets: / min_replies:	min_faves:500	互动量下限
filter:	filter:media、-filter:replies	只要带媒体的，或排除回复
#、@	#AI、@vercel	话题标签和提及

X 没有公开搜索框语法的完整清单，行为也会时不时调整。新写的查询先在 x.com 上试一下，网页结果对了，接口结果就一致。

价格和翻页

按页收费，和语法多少无关：每页约 20 条，$0.006。查询写得越精确越省钱，因为要翻的页更少。

任务	页数	费用
某个查询的前 100 条热门	5	$0.03
1,000 条	50	$0.30

sort=top 对应 X 的热门标签页，sort=latest 对应最新标签页。

curl -G "https://api.okdata.online/v1/x/posts/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query="claude code" lang:ja min_faves:100 -filter:replies' \
  --data-urlencode 'sort=top' \
  --data-urlencode 'fields=id,url,text,published_at,metrics.likes,metrics.views'

query 一定要用 --data-urlencode 传，引号、冒号和空格都需要编码。

和官方 API 的搜索有什么不同

X 官方 v2 搜索用的是另一套语法，比如 -is:retweet、has:media、is:reply。近期搜索只覆盖最近 7 天，所有开发者可用；全量历史搜索能回溯到 2006 年，按量付费和企业版账号可用，每返回一条帖子 0.005 美元。官方在 2026 年 1 月下线了互动量类语法，5 月搜索迁移到新索引后，又加回了 min_likes:、min_replies:、min_reposts:。需要有文档、有合同保障的搜索，用官方的；想直接用搜索框的语法、按页计费，用这里的。

注意事项

• 只返回公开帖子，受保护账号的内容不会出现。
• 时间跨度长的话，拆成几段较短的 since:/until:，配合 sort=latest 逐段跑，方便核对每一周都覆盖到了。
• 搜索结果里已经带浏览、点赞、回复、转发和书签数，一般不需要再逐条查详情。

想让 Agent 帮你写查询、直接跑，可以接入 MCP 服务。