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

# 有抖音视频 ID，怎么获取评论？

> 调用 POST /v1/social-data/call，指定 action 为 douyin.app.v3.fetch_video_comments 并传入字符串 aweme_id 与整数 cursor: 0，即可同步获取抖音视频的首批评论。

拿到抖音视频的作品 ID 后，调用 `POST /v1/social-data/call`，设置 `action` 为 `"douyin.app.v3.fetch_video_comments"`，传入字符串形式的 `aweme_id` 与整数 `cursor: 0`，即可同步获取首批评论。

## 首批评论请求示例

将下方请求中的 `<aweme_id>` 替换为真实作品 ID。接口同步返回标准 BeatAPI 信封结构（`object`、`status`、`request_id`、`action` 和 `data`）。

```bash
curl -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"douyin.app.v3.fetch_video_comments","params":{"aweme_id":"<aweme_id>","cursor":0}}'
```

客户端可能在超时后重试时，可附带 `Idempotency-Key` 请求头；同一个幂等键用于不同请求体会返回 `409 idempotency_conflict`。

## 保存与初筛返回结果

直接从实时返回的 `data` 中读取评论内容，不预设未公开的嵌套字段结构。将评论原句与视频来源链接、`request_id` 一并存档。例如排查咖啡机清洗演示遗漏的步骤时，先记录询问清洗步骤的评论与本批 `request_id`，再决定是否继续翻页或拉取评论回复。

## 合同与相关问题

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

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