> 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 续读评论。

今日头条的动作按链接类型选。图文链接（`/article/<id>/`）把 ID 作为 `group_id` 传给 `toutiao.app.get_article_info`；视频链接（`/video/<id>/`）把 ID 作为 `group_id` 传给 `toutiao.app.get_video_info`；作者主页链接把完整链接传给 `toutiao.app.get_user_id`。拿到作品 ID 后，用 `toutiao.app.get_comments` 读该作品的评论。

## 图文和视频分别怎么查？

完整链接是 `toutiao.com/article/123/` 时，取路径里的作品 ID（123 为示例），作为 `group_id` 传给 `toutiao.app.get_article_info`。视频链接 `toutiao.com/video/456/` 把 ID 作为 `group_id` 传给 `toutiao.app.get_video_info`。Web 图文 `toutiao.web.get_article_info` 和 Web 视频 `toutiao.web.get_video_info` 都用 `aweme_id` 接收作品 ID。所有动作里的 ID 都保留原始字符串。

## 怎样补读一篇图文的评论？

把下面的请求体发到 `POST https://api.beatapi.io/v1/social-data/call`，使用 BeatAPI Bearer 鉴权：

```json
{"action":"toutiao.app.get_comments","params":{"group_id":"123","offset":"0"}}
```

1. 第一批 `offset` 传 `"0"`。
2. 同一篇文章的每个后续批次把 `offset` 加 20，并以字符串发送：依次为 `"20"`、`"40"`。
3. 每一批结果单独保存为一个文件。
4. 遇到空批、重复批或达到读取上限时停止。

例如要收集安装步骤的疑问，表里保留评论原句、作品链接和请求号，读完评论原句后再归类。

`toutiao.app.get_comments` 只接收作品 ID 和 `offset`。编辑要按安装步骤看问题时，在本地保存的评论表里加一列「步骤」，同时保留评论的原顺序和来源。

## 有作者主页链接，怎么继续查资料？

把完整的作者主页链接作为 `user_profile_url` 传给 `toutiao.app.get_user_id`。从返回中确认作者和 `user_id` 后，把 `user_id` 传给 `toutiao.app.get_user_info`。两位作者同名时，用各自的主页链接区分。

[核对文章来源，把评论整理成修订清单](/zh/guides/toutiao) · [BeatAPI 价格页](https://beatapi.io/zh/pricing)