视频二级评论 API
用作品 ID 和一级评论的 comment_id 拉取回复,可翻页;每条返回评论 ID 和正文。
拉取视频号作品中某条一级评论下的回复。传入作品 feed_id 和父评论 comment_id,用 cursor 翻页;返回 items 回复列表,每项含 comment_id 和正文 content,并附 has_more。页码和每页条数不决定实际条数。
适合需要还原评论区讨论的舆情分析和用户反馈研究。先用视频号一级评论拿到 comment_id,再用本接口展开回复。一级评论不提供回复数,是否有回复以本接口为准。
请求地址 POST https://www.xmedi.cn/api/v1/wechat/channels/feeds/sub-comments。调用成功才扣费,参数错误、平台侧失败或超时不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 品牌舆情监测:针对争议较大的一级评论展开回复,判断讨论走向和情绪扩散情况。
- 用户反馈研究:查看用户在评论下的追问和互答,提炼真实使用问题。
- 客服跟进:找出品牌官方回复下的用户再追问,及时安排人工处理。
- 数据仓库定时入库:把一级评论与回复按 comment_id 关联入库,保留完整的对话结构。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
comment_id |
string | 是 | 父评论 ID,必填,取视频号一级评论返回的 comment_id。一级评论中的回复数仅供参考,是否有回复以本接口实际返回为准。 |
cursor |
string | 否 | 翻页游标,取上一页返回的 next_cursor;首页留空。 |
feed_id |
string | 是 | 视频号作品 ID,必填,纯数字字符串,例如 14991460993520372260。需与 comment_id 属于同一作品。 |
page |
integer | 否 | 页码,从 1 起。本接口按游标翻页,页码不决定返回哪一页。 |
page_size |
integer | 否 | 每页条数参数不生效,每页条数由平台决定,以返回的 items 长度和 page_size 为准。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
has_more | boolean | 是否还有下一页,true 表示可以继续翻页。 |
items | array<object> | 回复列表。每项包含 comment_id 回复的评论 ID 和 content 回复正文。没有回复时为空数组。 |
page | number | 当前页码,与请求中的 page 对应。 |
page_size | number | 本页的每页条数。 |
total | number | 本次结果条数或回复总数,以返回为准;是否继续翻页以 has_more 为准。 |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/wechat/channels/feeds/sub-comments \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"comment_id":"5333611842905301","feed_id":"14991460993520372260","page":1}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"has_more": false,
"items": [
{
"comment_id": "10000000000000000001",
"content": "示例回复内容一"
},
{
"comment_id": "10000000000000000002",
"content": "示例回复内容二"
}
],
"next_cursor": "示例值",
"page": 1,
"page_size": 10,
"total": 2
}
注意事项
- feed_id 和 comment_id 都必填,comment_id 必须来自同一作品的一级评论。
- 翻页可以让 page 递增,也可以把上一页返回的 next_cursor 填入 cursor;首页 cursor 留空。
- 很多一级评论没有回复,返回空列表属正常情况;可先筛选高赞或有讨论价值的评论再展开,节省调用次数。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 30 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- comment_id 从哪里获取?
- 先用视频号一级评论按 feed_id 拉取评论列表,每条评论的 comment_id 就是这里要传的父评论 ID。
- 怎么知道一条评论有没有回复?
- 一级评论返回的回复数只能作为参考,最准确的方式是对该 comment_id 调用本接口,items 为空即表示没有可获取的回复。
- 评论没有回复时会扣费吗?
- 调用成功才扣费,参数错误、平台侧失败或超时不扣费;成功但结果为空也算一次成功调用。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案