# 评论接口

> 11 个平台的 11 个接口，用同一个 Comment 对象返回评论。一条内容（视频、笔记或帖子）下面的评论，按页返回：评论内容、评论者、时间、点赞数和回复数。每次 $0.002 到 $0.02，各接口按自己的价格计费；失败的调用不扣费。

网页版：https://okdata.online/zh/roles/posts-comments-list/

## 各平台接口

| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| 抖音 | [抖音视频评论](https://okdata.online/zh/apis/douyin/videos/comments/list/) | `GET /v1/douyin/videos/comments/list` | 20 | $0.002/次 · 每页约 20 条评论 |
| 小红书 | [小红书笔记评论](https://okdata.online/zh/apis/xiaohongshu/notes/comments/list/) | `GET /v1/xiaohongshu/notes/comments/list` | 10 | $0.02/次 · 每页约 10 条评论 |
| B站 | [B站视频评论](https://okdata.online/zh/apis/bilibili/videos/comments/list/) | `GET /v1/bilibili/videos/comments/list` | 20 | $0.002/次 · 每页约 20 条评论 |
| TikTok | [TikTok 视频评论](https://okdata.online/zh/apis/tiktok/videos/comments/list/) | `GET /v1/tiktok/videos/comments/list` | 50 | $0.002/次 · 每页约 50 条评论 |
| YouTube | [YouTube 视频评论](https://okdata.online/zh/apis/youtube/videos/comments/list/) | `GET /v1/youtube/videos/comments/list` | 20 | $0.002/次 · 每页约 20 条评论 |
| Instagram | [Instagram 帖子评论](https://okdata.online/zh/apis/instagram/posts/comments/list/) | `GET /v1/instagram/posts/comments/list` | 15 | $0.004/次 · 每页约 15 条评论 |
| Reddit | [Reddit 帖子评论](https://okdata.online/zh/apis/reddit/posts/comments/list/) | `GET /v1/reddit/posts/comments/list` | 10 | $0.002/次 · 每页约 10 条评论 |
| 快手 | [快手作品评论](https://okdata.online/zh/apis/kuaishou/videos/comments/list/) | `GET /v1/kuaishou/videos/comments/list` | 10 | $0.002/次 · 每页约 10 条评论 |
| 微信视频号 | [视频号作品评论](https://okdata.online/zh/apis/wechat_channels/videos/comments/list/) | `GET /v1/wechat_channels/videos/comments/list` | 25 | $0.015/次 · 每页约 25 条评论 |
| 微博 | [微博评论](https://okdata.online/zh/apis/weibo/posts/comments/list/) | `GET /v1/weibo/posts/comments/list` | 20 | $0.002/次 · 每页约 20 条评论 |
| 微信公众号 | [公众号文章评论](https://okdata.online/zh/apis/wechat_mp/articles/comments/list/) | `GET /v1/wechat_mp/articles/comments/list` | 20 | $0.02/次 · 每页约 20 条评论 |

## 返回的对象：[Comment](https://okdata.online/zh/docs/objects/comment/)

上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。

| 字段 | 类型 | 含义 |
|---|---|---|
| `id` | `string` | 评论 ID。 |
| `post_id` | `string` | 所属内容的 ID。 |
| `parent_id` | `string \| null` | 回复的上级评论；一级评论为 null。 |
| `text` | `string` | 评论内容。 |
| `published_at` | `string` | 发布时间，ISO 8601，UTC。 |
| `author` | `AccountRef` | 评论者。 |
| `likes` | `integer \| null` | 评论点赞数。 |
| `replies` | `integer \| null` | 回复数。 |
| `ip_location` | `string \| null` | 平台显示的 IP 属地（有的话）。 |
| `ext` | `object` | 平台特有字段，只在 view=full 时返回。 |

## 两个平台上的同一个调用

参数一样、翻页方式一样、返回结构一样，只换路径。

```bash
# 抖音
curl -G "https://api.okdata.online/v1/douyin/videos/comments/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=7301234567890123456'

# 小红书
curl -G "https://api.okdata.online/v1/xiaohongshu/notes/comments/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=6650a1b2000000001e00abcd'
```

## 常见用途

- 看竞品新品视频下面，买家在夸什么、骂什么。
- 把一周的评论交给模型做情感分析，找出反复出现的痛点。
- 投放前看看达人的评论区像不像真人在说话。

## 常见问题

### 能拿到一条内容下的全部评论吗？

能拿到平台公开展示的部分，一页一页翻：把 page.next_cursor 原样作为 cursor 传回，直到 page.has_more 为 false。平台会折叠或隐藏一部分评论，所以总数可能比内容上显示的评论数略少。

### 评论的回复也包括在内吗？

一级评论会带上回复数。平台有“评论回复”接口的，会列在评论回复那一页；没有的话就拿不到回复内容。

### 一页评论多少钱？

每一页是一次调用，按上表里该接口的价格计费。调用失败或者内容已经不存在，都不扣费。

## 其他数据类型

- [热榜接口](https://okdata.online/zh/roles/trends-list/)
- [评论回复接口](https://okdata.online/zh/roles/comments-replies-list/)
- [话题内容接口](https://okdata.online/zh/roles/topics-posts-list/)
- [账号信息接口](https://okdata.online/zh/roles/accounts-get/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [热门内容接口](https://okdata.online/zh/roles/posts-trending/)
- [账号搜索接口](https://okdata.online/zh/roles/accounts-search/)
- [内容数据接口](https://okdata.online/zh/roles/posts-metrics/)
- [社区帖子接口](https://okdata.online/zh/roles/communities-posts-list/)
- [广告详情接口](https://okdata.online/zh/roles/ads-get/)
- [广告主广告列表接口](https://okdata.online/zh/roles/advertisers-ads-list/)
- [广告搜索接口](https://okdata.online/zh/roles/ads-search/)
- [字幕接口](https://okdata.online/zh/roles/transcripts-get/)
- [粉丝列表接口](https://okdata.online/zh/roles/accounts-followers-list/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)
- [达人搜索接口](https://okdata.online/zh/roles/creators-search/)
- [达人详情接口](https://okdata.online/zh/roles/creators-get/)
- [达人粉丝画像接口](https://okdata.online/zh/roles/creators-audience-get/)