切换 API 能力

查询公众号文章评论

可直接调用

按文章链接查询该文精选评论的正文、时间与点赞数，含作者回复。出于个人信息最小化，刻意不返回评论者昵称、头像与地域。翻页请回传上一页的 nextCursor。

POSThttps://doubaoya.com/api/apis/gongzhonghao/article-comments/call

直接调用

最快怎么用？

先在登录工作台用示例输入跑通结果，再复制请求接入。字段表和状态码在下方，真正开发时再看就行。

获取 Key

你只需要准备

公开链接https://mp.weixin.qq.com/s/fMLx7oTDUqRXxtIHW9_fPQ

三步完成

1. 打开直接调用工作台，示例 JSON 已经帮你填好。
2. 使用登录会话完成校验和调用，先确认返回结果是不是你要的。
3. 复制 cURL 或 JavaScript 示例，放到你的产品/脚本里。

API Key 获取与配置

工作台直接调用使用登录会话，不需要粘贴密钥；API Key 留给自己的产品、脚本或 Agent 接入。

获取密钥

获取步骤

1. 前往控制台页面，进入 API 密钥管理模块。
2. 若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
3. 调用时统一带 Authorization: Bearer <你的 key> 请求头即可。

详细接入信息

Method：POST

Host：https://doubaoya.com

Path：/api/apis/gongzhonghao/article-comments/call

请求头

请求头
名称	类型	必填	说明	示例
Authorization	string	是	用于识别你的账号，每次请求必填，格式 Bearer + 空格 + 密钥	Bearer dyh_xxxxxx
Content-Type	string	是	请求体数据类型	application/json

输入字段

当前目录提供请求示例，未声明 required 元数据；下列字段仅表示示例结构，实际约束以接口校验结果为准。

输入字段
字段	类型	字段性质	说明	示例
url	String	示例字段	公开链接	https://mp.weixin.qq.com/s/fMLx7oTDUqRXxtIHW9_fPQ

返回字段

返回字段
字段	类型	说明	示例
success	Boolean	是否成功	true
requestId	String	请求追踪 ID	req_xxx
commentId	String	commentId	4543783942687293652
content	String	content	示例评论正文一，用于断言正文被保留。
createdAt	String	createdAt	2023-05-13 00:05:03
likeCount	Integer	likeCount	3
replies	Array	replies	[]

常见状态码说明

错误码与排查建议
状态码	说明	排查建议
400	输入内容有误	检查示例 JSON 中的字段、链接或关键词是否填写正确。
401	鉴权失败	确认请求头已添加 API Key，且密钥有效、未禁用。
402	积分不足	账户点数不足，本次调用未执行，请前往账户页查看点数获取方式。
502	数据源暂时不可用	稍后重试；持续出现请联系技术支持。

在工作台直接调用

登录会话会安全完成参数校验和真实调用，不需要在公开页面粘贴 API Key。

登录后直接调用管理 API Key

复制接入

1. 复制下方请求示例。
2. 把 your_api_key 换成你的 Key。
3. 替换示例输入，读取响应里的 success、requestId 和 data。

Request 示例代码，仅供参考

Shell

curl -X POST "https://doubaoya.com/api/apis/gongzhonghao/article-comments/call" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -d '{"url":"https://mp.weixin.qq.com/s/fMLx7oTDUqRXxtIHW9_fPQ"}'

Response

{
  "success": true,
  "requestId": "req_xxx",
  "data": {
    "source": "gzh.articleComments",
    "items": [
      {
        "commentId": "4543783942687293652",
        "content": "示例评论正文一，用于断言正文被保留。",
        "createdAt": "2023-05-13 00:05:03",
        "likeCount": 3,
        "replies": []
      },
      {
        "commentId": "4543783942687293653",
        "content": "示例评论正文二，带一条作者回复。",
        "createdAt": "2023-05-13 00:05:03",
        "likeCount": 0,
        "replies": [
          {
            "content": "示例作者回复正文。",
            "createdAt": "2023-05-13 00:05:03",
            "likeCount": 0
          }
        ]
      }
    ],
    "hasMore": true,
    "nextCursor": "GAEgADAAOAFAAUgAUAA="
  },
  "error": null
}