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

# 只想先看看 TikTok 观众在说什么，第一轮该怎么取？

> 已有视频ID先取一页并保留来源，检查相关性和上下文后再决定是否扩大，不为导出重复查询已有结果。

第一轮只取一页：调用 `tiktok.app.v3.fetch_video_comments`，把视频 ID 按字符串传给 `aweme_id`，`cursor` 设为 `0`。保存完整响应，确认评论来自目标视频，再从实际返回的评论里挑原句。读完第一页再决定要不要补回复或翻页。

例如想找观众对产品安装的疑问，先看问步骤或使用条件的评论。手上只有工具预览时，先取回同一次请求的已保存结果。 [结果读取合同](/zh/capabilities)

## 第一轮前，先确认三件事

| 你现在手里有什么         | 直接怎么做                                                 |
| ---------------- | ----------------------------------------------------- |
| 标准视频链接或已核对的视频 ID | 直接用视频 ID 准备评论请求，不必为取得已知 ID 再买视频详情。                    |
| 只有短链或目标不明        | 先[整理链接与目标](/zh/faq/tiktok-video-id)，核对最终作品，或另行批准链接解析。 |
| 这一页的原始响应已经保存     | 直接阅读已保存的响应并记录来源，不为整理表格重复取数。                           |

确认目标视频后，免费 Inspect `data:tiktok.app.v3.fetch_video_comments`，查看当前可执行状态、输入和价格。只批准一页，不自动增加搜索、详情、回复或下一页。

## 一页读取入口

一级评论动作是 `tiktok.app.v3.fetch_video_comments`：视频 ID 以字符串传给 `aweme_id`，第一次请求用整数 `cursor: 0`。下面的请求模板只用于已核对的目标视频，并且只在已批准的范围内使用：

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

保留 HTTP 状态、请求号、实际时间和原始响应，先确认执行成功再读内容。成功的空页、请求失败和缺少正文是三种不同情况，都不能单独写成「没人讨论」。评论动作目前没有已验证的固定评论列表结构，所以本页不提供自动 CSV，也不假定列表路径或每页固定条数。

## 读完第一页，怎么决定下一步？

* 多数评论与研究无关：先核对视频和研究问题，换更相关的视频往往比继续翻页有用。
* 有具体问题，但原话依赖上下文：选出对应的父评论，另行批准[补读回复](/zh/faq/tiktok-comment-replies)，在此之前标为「待核」。
* 材料相关但还不够：按[样本数和预算](/zh/faq/tiktok-comment-count)确认上限，再用实际返回的游标继续，不手动加一。
* 已足以形成研究线索：先整理问题、逐字原句、来源和下一步核查，再决定是否扩大样本。

第一页得到的是已读样本中的线索，不是全体观众的需求比例，也不代表所有回复都已读完。完整的研究方法见[视频评论指南](/zh/guides/tiktok-video-comments)。

免费合同：`data:tiktok.app.v3.fetch_video_comments`、`data:tiktok.app.v3.fetch_video_comment_replies`。本页不承诺命中数量。