> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# X 怎么按关键词搜最新帖子，不要热门排序？

> 在 twitter.web.fetch_search_timeline 中显式设置 search_type 为 Latest 可搜索 X 最新帖子，不传时默认 Top，且 Top 与 Latest 游标链不能混用。

要在 X 上搜索最新帖子，调用 `twitter.web.fetch_search_timeline`，将搜索词填入 `keyword` 并显式设置 `search_type:"Latest"`。省略 `search_type` 时默认使用 `"Top"`，返回平台热门搜索结果。例如产品刚发布时，可先跑一轮 `Latest` 搜索排查新出现的问题反馈，再单独跑一轮 `Top` 搜索查看热门讨论。

## 我的任务该用哪种排序？

| 你的任务            | `search_type`        | 交付时保留                   |
| --------------- | -------------------- | ----------------------- |
| 看品牌最近出现哪些新问题    | `Latest`             | 原帖 ID、正文、发布时间、查询时间、跟进依据 |
| 了解平台热门搜索结果在讨论什么 | `Top`                | 原查询与排序、原响应位置、正文证据       |
| 比较两种视角          | 分开查 `Top` 和 `Latest` | 两份独立清单，不混接同一条游标链        |

`Top` 不是在本地按点赞数降序排列，`Latest` 也不是在本地按时间重排。请保留响应返回的帖子顺序；若后续在本地自定义排序，须标明自定义规则，不要把本地排名写成官方热度。

## 先保存两个请求，再决定是否都执行

下面的示例使用 `weather forecast`。请将 `weather forecast` 替换为实际搜索词，并把 `Latest` 请求体保存为 `request-latest.json`：

```json
{"action":"twitter.web.fetch_search_timeline","params":{"keyword":"weather forecast","search_type":"Latest"}}
```

仅当确实需要热门视角时，才将 `Top` 请求体另存为 `request-top.json`，不要覆盖 `request-latest.json`：

```json
{"action":"twitter.web.fetch_search_timeline","params":{"keyword":"weather forecast","search_type":"Top"}}
```

先通过免费的 Inspect 调用核对当前价格，再只批准需要的请求。按当前价格，拉取一页 `Latest` 估算 `$0.003`，两种排序各拉一页估算 `$0.006`。在本地写入 JSON 文件不触发请求，下面的 `curl` 命令才会发起新的计费调用。不要为了展示效果同时跑两种排序，也不要把一页预算自动扩展为连续翻页。

```bash
mkdir x-latest-run-1 &&
curl -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @request-latest.json \
  -D x-latest-run-1/headers.txt \
  -o x-latest-run-1/response.json
```

在新目录 `x-latest-run-1` 旁记录实际采集时间与 HTTP 状态码，再检查 `response.json` 中的 `status`、`action`、`request_id` 和 `data.timeline`——HTTP 请求完成并不代表业务结果成功。若 `data.timeline` 为空，按[空结果排查](/zh/faq/x-empty-search-results)定位原因，不要直接改词或换排序再次付费。

## 有游标时能中途从Top切成Latest吗？

不能。`Top` 搜索返回的 `data.next_cursor` 无法接续 `Latest` 搜索。续页时必须保持完全相同的 `keyword` 和 `search_type`，仅补充上一页返回的游标。更换 `search_type` 或 `keyword` 属于一次新搜索，应从不带游标的第一页开始，并单独记录成本、清单和输出目录。完整采集与已存响应导出见[搜索CSV指南](/zh/guides/x-search-posts)。

不要为了修复本地 CSV 重新发起采集。使用指南中的本地导出器将已保存响应分别导出到 `top-review` 与 `latest-review` 两个目录。同一 `tweet_id` 同时出现在两份导出中时，说明 `Top` 和 `Latest` 命中了同一条帖子而非两条帖子；按 `tweet_id` 对齐两份导出，保留每次观察的采集时间和计数，避免一份导出覆盖另一份。

## 最后给业务方看什么？

近期问题清单应逐条列出原帖 ID 或链接、简短原句、问题分类、跟进理由和来源时间，只给总条数不算简报。热门观察需附上选中的帖子作为支撑证据。`Top` 页与 `Latest` 页的差异不代表全平台舆情转向。不要把 `null` 浏览量改写为 0，具体处理方式见[浏览量覆盖报告](/zh/faq/x-missing-views)。

免费合同参考：`data:twitter.web.fetch_search_timeline`。