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

# AI 只显示五条评论，是接口只取到五条吗？

> AI 只展示 5 条评论通常源于 view: preview（MCP 默认 max_items: 5），应核对 items_total，并在 1 小时内通过 operation: result 与 request_id 免费读回完整结果。

不一定。助手只展示 5 条评论，通常是触发了 `view: "preview"` 预览视图（MCP 默认模式，默认 `max_items: 5`，最高 `50`），并不代表接口只拉到了 5 条。先查看响应中的 `items_total`、`truncated` 和 `next` 字段，再判断实际返回条数。

## 在 1 小时内免费读回完整结果

例如助手仅展示 5 条，但 `items_total` 显示 `18` 时，全部 18 条评论已按本次 `request_id` 暂存 1 小时。使用同一把 API Key、原始 `reference`、`operation: "result"` 和 `request_id` 调用 `POST /v1/capabilities/run`，即可免费取回完整批次（也可附带 `fields` 只保留指定的 `items[].<key>` 路径）：

```json
{
  "reference": "data:douyin.app.v3.fetch_video_comments",
  "operation": "result",
  "request_id": "<request_id>"
}
```

超过 1 小时后，`operation: "result"` 会返回 `404 result_expired`，届时需重新发起运行。

## 区分读回结果与抖音翻页

沿用 `next` 发起 `operation: "result"` 用于补读同一批已缓存结果；只有需要从抖音拉取新的一页评论时，才使用平台响应游标。读回已存结果的方法见[能力合同](/zh/capabilities)，从抖音取下一页的方法见[评论分页](/zh/faq/douyin-comment-pagination)。在表中写出「本次返回 18 条，已阅读 18 条」前，先确认 18 条已全部取回并核对。

## 合同与相关问题

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

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