跳到导航

AI 只显示五条评论,是接口只取到五条吗?

不一定。助手只展示 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> 路径):

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

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

区分读回结果与抖音翻页

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

合同与相关问题

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

返回抖音问题索引。