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

> 通过 API 使用 X（推特）高级搜索语法，比如 from:、since:、lang:、min_faves:：常用写法、每页价格，以及和官方 API 搜索语法的区别。

网页版：https://okdata.online/zh/answers/x-search-operators-api/

**简短回答：**能。X 帖子搜索会把你的查询原样交给 X 自己的搜索，所以 X 搜索框里能用的语法这里都能用：from:、to:、引号短语、OR、减号、lang:、since:、until:、min_faves:、filter:media、-filter:replies 等。不管写了多少语法，每页约 20 条都是 $0.006，1,000 条匹配结果共 $0.30。

比如你想找上周提到某个产品的日语帖子，要求点赞过百、排除回复。在 X 搜索框里一行就够：`"claude code" lang:ja since:2026-11-05 min_faves:100 -filter:replies`。把这一行原样作为 [X 帖子搜索](/zh/apis/x/posts/search/)的 `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` 对应最新标签页。

```bash
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 服务](/zh/mcp/)。

## 用到的接口

- [X 帖子搜索](https://okdata.online/zh/apis/x/posts/search/) `x.posts.search`：$0.006/次 · 每页约 20 条帖子

更新于 2026-11-12