欢迎访问极媒数据 · 新媒体数据服务平台 登录 免费注册 控制台
新媒体数据
服务平台
首页接口文档视频号视频二级评论

视频二级评论 API

视频号¥0.15/次每分钟 30 次

用作品 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_moreboolean是否还有下一页,true 表示可以继续翻页。
itemsarray<object>回复列表。每项包含 comment_id 回复的评论 ID 和 content 回复正文。没有回复时为空数组。
pagenumber当前页码,与请求中的 page 对应。
page_sizenumber本页的每页条数。
totalnumber本次结果条数或回复总数,以返回为准;是否继续翻页以 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 留空。
  • 很多一级评论没有回复,返回空列表属正常情况;可先筛选高赞或有讨论价值的评论再展开,节省调用次数。

常见错误码

codeerror_code含义与处理
40001VALIDATION_ERROR参数校验失败,按返回提示修改请求,不扣费
40100UNAUTHORIZEDAPI Key 缺失、错误或已吊销,到控制台检查 Key
40200INSUFFICIENT_BALANCE余额不足,充值后重试
42900RATE_LIMITED超过每分钟 30 次上限,稍后重试
50000INTERNAL_ERROR服务异常,可稍后重试,不扣费
50300NOT_AVAILABLE接口暂不可用,不扣费

常见问题

comment_id 从哪里获取?
先用视频号一级评论按 feed_id 拉取评论列表,每条评论的 comment_id 就是这里要传的父评论 ID。
怎么知道一条评论有没有回复?
一级评论返回的回复数只能作为参考,最准确的方式是对该 comment_id 调用本接口,items 为空即表示没有可获取的回复。
评论没有回复时会扣费吗?
调用成功才扣费,参数错误、平台侧失败或超时不扣费;成功但结果为空也算一次成功调用。

相关接口

需要接入这个接口?

注册后创建 API Key,或留下联系方式获取方案

免费注册
×

微信号 xmedi369