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

# App 评论的下一页，是把 next_offset 加一吗？

> B 站 App 评论分页使用 bilibili.app.fetch_video_comments，首页传 next_offset:1，续页原样回传响应返回的续页值而不加一。

不是。B 站 App 评论翻页时不要把 `next_offset` 加一。调用 `bilibili.app.fetch_video_comments` 获取首页时传入 `next_offset:1`，翻到下一页前先检查完整响应里是否还有下一页，再把响应实际返回的续页值原样作为下一次请求的 `next_offset`。

## next_offset 续页规则

`bilibili.app.fetch_video_comments` 采用响应驱动的续页方式，而不是按页码递增：

* **第一页：** 传入 `next_offset:1`，并指定目标视频标识和排序参数 `mode`。
* **后续页：** 查看 `bilibili.app.fetch_video_comments` 的完整响应确认仍有下一页后，将响应返回的续页值原样传给 `next_offset`。
* **保持查询范围一致：** 同一条翻页链中，视频标识和 `mode` 必须全程保持不变。

## 排序模式与独立分页链

不同 `mode` 值对应彼此独立的评论序列：

* **按时间排序（`mode:2`）：** 第一页使用 `mode:2` 时，后续每一页都沿用同一视频标识和 `mode:2`。
* **热门评论（`mode:3`）：** 需要查看热门评论时，不要在中途修改 `mode`，而应使用 `mode:3` 和 `next_offset:1` 另起第一页请求。
* **Web 评论分页：** 如果调用的是 B 站 Web 评论动作而非 `bilibili.app.fetch_video_comments`，请按 [Web 分页](/zh/faq/bilibili-web-pagination) 的规则翻页。

## 停止条件与请求计费

遇到以下任一情况时立即停止翻页并记录原因：

1. 响应中的续页值缺失，或与之前已请求过的续页值重复。
2. `bilibili.app.fetch_video_comments` 请求失败。
3. 已达到业务设定的页数上限。

每次翻页请求单独计一次请求费用。