> 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.

# 下一页的 cursor 是不是直接加一？

> 调用 douyin.app.v3.fetch_video_comments 翻页时不要把 cursor 手动加 1，应将上一页响应返回的游标原样作为下一页的 cursor，并保持同一个 aweme_id。

不是。翻页时不要把 `cursor` 手动加 `1`。继续调用 `douyin.app.v3.fetch_video_comments` 拉取下一页时，必须把上一页响应实际返回的游标原样填入 `cursor`，同时保持同一个视频的 `aweme_id`。

## 正确的连续翻页方式

1. 首次调用 `POST /v1/social-data/call` 时，传入字符串形式的 `aweme_id` 与整数 `cursor: 0`。
2. 从上一页返回的实际响应中读取游标值，原样传入下一次请求的 `cursor` 字段，并将每一页单独保存为独立文件。
3. 例如第一页已发现安装类问题、需要继续收集其他机型的反馈时，使用第一页返回的游标再次请求同一视频，不要自行递增数字。

## 停止条件与失败页处理

出现以下任一情况即刻停止翻页：

* 已达到原计划的读取页数上限。
* 响应缺失游标，或返回与前面重复的游标。
* 本页返回空评论批次。
* 某次分页请求执行失败。

在最终整理报告中标明实际读完的页数。失败的请求不消耗积分；若后续某页读取失败，记录失败页的入参与 `request_id` 以便排查，已保存的前序评论照常分析。

## 合同与相关问题

执行前，免费检查 `data:douyin.app.v3.fetch_video_comments` 合同。

[返回抖音问题索引](/zh/faq/douyin)。