视频评论 API
用视频 ID、链接或分享文案拉一级评论,游标翻页。每条含评论 ID、正文、点赞,以及用来拉回复的 reply_cursor。
拉取 YouTube 视频的一级评论。video_id、视频链接、分享文案三选一,用 cursor 翻页。每条含评论 ID、正文、作者、点赞数、发布时间、回复数 reply_num,以及有回复时的 reply_cursor。
回复正文不在本接口。要回复时,把该条的 reply_cursor 交给评论回复接口,不要用 comment_id。
请求地址 POST https://www.xmedi.cn/api/v1/youtube/videos/comments。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 舆情:翻完评论,看差评集中在哪些说法。
- 选达人:看评论区是否在讨论产品使用问题。
- 入库:按 comment_id 去重后写入评论表。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
cursor |
string | 否 | 翻页游标,取上一页 next_cursor;首页留空。 |
page |
integer | 否 | 页码,从 1 起;默认 1;最小 1 |
page_size |
integer | 否 | 每页条数;默认 20;范围 1~100 |
share_text |
string | 否 | 含视频链接的分享文案。 |
url |
string | 否 | 视频链接,形态与视频详情相同。 |
video_id |
string | 否 | 11 位视频 ID。与 url、share_text 三选一。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
has_more | boolean | 是否还有下一页。 |
items | array<object> | 评论列表。每条含 comment_id、content、author.name、like、publish_time、reply_num。有回复时还有 reply_cursor,只用于拉这一条的回复。 |
next_cursor | string | |
page | number | |
page_size | number |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/youtube/videos/comments \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"page":1,"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"has_more": false,
"items": [
{
"author": {
"name": "示例用户"
},
"comment_id": "Ugxxxxxxxxxxx",
"content": "示例评论内容",
"like": 2,
"publish_time": "2026-01-01T00:00:00Z",
"reply_cursor": "reply-cursor-example",
"reply_num": 1
}
],
"next_cursor": "",
"page": 1,
"page_size": 20,
"total": 1
}
注意事项
- 评论区关闭或没有评论时,以返回的空列表和状态码判断是否计费。
- 本接口是一级评论。回复用评论回复接口,入参是本条的 reply_cursor,不是 comment_id,也不是翻页的 next_cursor。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 能拉回复吗?
- 本接口不返回回复正文。reply_num 大于 0 时,用该条的 reply_cursor 调评论回复。reply_cursor 为空就没有可翻的回复。
- 怎么翻页?
- 把上一页的 next_cursor 填回 cursor。has_more 为 false 时停止。reply_cursor 不能用来翻一级评论。
- 调用失败会扣费吗?
- 视频不存在或参数无效不扣费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案