公众号文章评论回复 API 试运行
文章二级评论
获取公众号文章某条一级评论下的回复(二级评论)。请求传入 comment_id,并用 url、article_url 或 article_id 指定文章;返回 items 回复列表及 has_more、page_size、total。
适合深入分析评论区的舆情和用户研究团队:先用公众号文章评论列表拿到 comment_id,再对回复较多的评论调用本接口,展开完整讨论链。
请求地址 POST https://www.xmedi.cn/api/v1/wechat/articles/sub-comments。试运行期间调用成功也不扣费。
成功响应的 meta 含数据血缘,说明见 鉴权与计费。
适用场景
- 品牌舆情监测:针对涉及品牌的高赞评论,拉取其下的回复,判断讨论走向与情绪。
- 用户研究:分析热门评论下的追问和回复,挖掘读者的真实疑问与需求。
- 内容选题研究:从评论回复中的争议点提炼后续选题。
- AI 应用知识库补充:把文章正文、评论与回复一并整理,用于观点归纳和问答训练素材。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
article_id |
string | 否 | 文章 sn,即链接中 /s/ 后面那一段或长链中的 sn 参数,平台会补成完整链接。与 url、article_url 三选一。 |
article_url |
string | 否 | 文章链接,与 url 等价,三选一填写。 |
comment_id |
string | 是 | 必填。一级评论 ID,字符串,取自公众号文章评论列表返回的 items[].comment_id,例如 4311481105950703697。 |
url |
string | 否 | 文章链接,支持 https://mp.weixin.qq.com/s/… 短链或带 __biz 的长链。与 article_url、article_id 三选一。 |
返回 data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
has_more | boolean | 是否还有更多回复,布尔值。 |
items | array<object> | 回复列表,数组。每条通常包含回复 ID、回复内容、回复者昵称、点赞数、回复时间、IP 属地等,具体字段以实际返回为准。该评论没有回复时为空数组。 |
page | number | 当前页码,数字。 |
page_size | number | 本页条数,数字。 |
total | number | 回复总数,数字。 |
调用示例
curl -X POST https://www.xmedi.cn/api/v1/wechat/articles/sub-comments \
-H "X-XMEDI-Key: xm_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"comment_id":"4311481105950703697","page":1,"url":"http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==\u0026mid=2667026902\u0026idx=1\u0026sn=625cd9b1604b0968a3dcb98380a931ff"}'
返回示例
以下为 data 的字段结构示意,实际取值以调用结果为准。
{
"has_more": false,
"items": [
{
"comment_id": "1000000000000000001",
"comment_time": "2026-01-01T08:00:00Z",
"content": "示例回复内容",
"ip_region": "示例地区",
"like_num": 10,
"nickname": "示例用户"
}
],
"page": 1,
"page_size": 20,
"total": 1
}
注意事项
- comment_id 必须来自同一篇文章的一级评论,文章参数要与之对应,否则可能查不到回复。
- url、article_url、article_id 三选一指定文章即可,长链、短链都支持。
- 建议只对一级评论中 reply_num 大于 0 的评论调用本接口,减少无效请求。
常见错误码
| 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 从哪里拿?
- 先调用公众号文章评论列表,返回的 items 中每条一级评论都有 comment_id 和 reply_num,选取 reply_num 大于 0 的评论传入本接口即可。
- 和文章评论列表有什么区别?
- 文章评论列表返回文章下的一级评论;本接口返回某条一级评论下面的回复,两者配合可以还原完整的评论区。
- 没有回复会扣费吗?
- 调用成功才扣费,参数错误、平台侧失败或超时不扣费。调用成功但该评论没有回复、items 为空,也算一次成功调用。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案