> 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 搜索结果怎么取下一页？

> X 搜索翻页需在 twitter.web.fetch_search_timeline 中保持 keyword 与 search_type 不变，将上一页的 data.next_cursor 原样传入 params.cursor，遇缺失、重复或空页游标即停止。

获取 X 搜索下一页时，再次调用 `twitter.web.fetch_search_timeline`，保持 `keyword` 和 `search_type` 不变，并将上一页响应中的 `data.next_cursor` 原样传入 `params.cursor`。第一页省略 `cursor`；更换搜索词或在 `Top` 与 `Latest` 之间切换时，从不带 `cursor` 的第一页重新开始。

例如第一页以品牌名和 `search_type:"Latest"` 搜索，第二页发送相同的品牌名、`search_type:"Latest"` 以及第一页返回的 `data.next_cursor`。完整流程见[搜索与 CSV 导出](/zh/guides/x-search-posts)。

## 何时停止，交付时怎样解释？

根据 `coverage.json` 中记录的停止状态决定下一步：

| `coverage.json` 状态  | 下一步                                      | 能在报告里写什么                      |
| ------------------- | ---------------------------------------- | ----------------------------- |
| `saved_batch_ended` | 已保存批次到达末页；仅在预算允许时发送 `next_params` 获取下一页。 | 已处理所保存的页面，结果属于抽样而非全量。         |
| `cursor_absent`     | 停止，不再发送请求。                               | 本次响应未返回续页游标；没有游标不能证明已覆盖全部历史。  |
| `repeated_cursor`   | 停止并核查原始响应文件。                             | 游标重复，继续翻页可能进入死循环。             |
| `empty_with_cursor` | 停止并排查空结果。                                | 本页请求成功但返回零条帖子且附带游标，不要自动再买下一页。 |

HTTP 错误、业务失败、动作不匹配、缺少数组以及损坏的 JSON 均属于失败而非成功空页。请保留请求记录和原始响应字节，并按[空结果排查](/zh/faq/x-empty-search-results)定位原因。本流程不会自动重试。若在 `empty_with_cursor` 停止后获批进一步排查，应将排查请求存为新批次，不要接在已停止的游标链后。

## 两页预算是40条吗？

不是。两页预算限制的是请求次数，并不保证每页条数、去重后的独立帖子数或覆盖的时间范围。第二页可能与第一页出现重叠帖子，因此去重后行数减少不代表漏采。

按当前 Inspect 价格每次请求 `$0.003` 计算，两次成功请求估算 `$0.006`（不含重试与额外页）。遇到空页或缺失游标时应提前停止，不要为凑满两页花掉剩余预算。

## 已经存了JSON，怎么继续而不重复付费？

使用指南中的本地导出器 `export_saved_x.py` 处理已保存响应；拉取数据与导出本地响应属于两条独立流程。

1. 在 `pages.json` 中记录每页的实际参数、查询时间和原始响应文件名。
2. 运行 `export_saved_x.py`。`export_saved_x.py` 会在不联网的情况下校验每页 `keyword` 与 `search_type` 一致、游标依次衔接、请求号互不重复且采集时间有序，并输出 `posts.csv`、`coverage.json`、`sources.json` 及原始文件的逐字节副本。
3. 续页前先查看 `stop_reason`。只有状态为 `saved_batch_ended` 且 `next_params` 有效时才准备续页，发送前仍需确认预算。
4. 保存新响应后，将新一页的实际记录追加到 `pages.json`，再导出到新的输出目录。

不要为了增加 CSV 列或调整本地解析而重跑第一页采集。

## 重叠、时间和证据怎么写进报告？

`posts.csv` 保留每个原始 `tweet_id` 的首次观察；同一帖子的后续观察留在原始 JSON 中，重复条数记录在 `coverage.json`。不要用后一次抓取的点赞数覆盖首次观察值。

报告中须写明样本实际最早和最晚的 `created_at` 以及每一页的采集时间。两页样本的帖子数量不等于关键词的总提及量。文件哈希仅用于标识保存下来的字节，无法证明服务器真实性、采集时间准确性或数据完整性。

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