微信公众号文章评论 API

按文章链接 url 读一篇公众号文章下的评论:text、like_count、posted_at、is_top、reply_count,以及评论者的 country 和 province,每千次 $6.76。

文章评论按公众号文章的 url 读取这篇文章下的评论:评论 id、正文 text、评论者昵称和头像、点赞数 like_count、发布时间 posted_at,以及是否置顶 is_top、回复数 reply_count 和评论者所在的国家、省份。收集读者反馈、做口碑抽样,或把置顶评论单独拎出来看,都从这里取数。

reply_count 为 null 表示不公开,不等于没有回复;想看某条评论下的回复,把这条评论的 ID 和同一个文章链接交给评论回复那一页。评论时间 posted_at 是 UTC 时区的 ISO 8601 格式,展示前要换算成本地时间。

  • 评论的 id 在读回复时作为 comment_id
  • reply_count 只是回复个数,回复本身用 comment_replies 读
  • 失败和空结果不收费
免费开始

高峰时段可能暂时不可用

这项能力在高峰时段可能暂时不可用,稍后重试即可;失败的调用不扣费。

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "wechat_oa",
      "action": "article_comments",
      "params": {
        "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "author_name": "",
          "text": "我曾经因为不刮腋毛被朋友说“恶心”。。。。。\n不知道哪里来的这种审美捆绑。。。。。。\n谢谢丁香为我正名!!!!!",
          "like_count": 1056,
          "posted_at": "2026-07-31T03:59:18+00:00"
        },
        …
      ],
      "count": 20
    }
  3. 3行

    author_nametextlike_countposted_at
    我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!!10562026-07-31T03:59:18+00:00
    有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期2352026-07-31T03:59:05+00:00
  4. 4CSV

    wechat_oa-article_comments-sample.csv id,text,author_name,author_avatar_url,like_count,posted_at,is_top,reply_count,country,province,platform

请求带文章 url,返回这篇文章的一批评论,results 里每行是一条评论,列成字段表,也可下载为 CSV。

能拿到什么数据

下表取自对 mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0 的一次真实调用,采集于 2026年10月25日 02:28(UTC),共返回 20 行;灰条是隐去的个人信息(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。

idtextauthor_nameauthor_avatar_urllike_countposted_atis_topreply_countcountryprovinceplatform
我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!!10562026-07-31T03:59:18+00:0004中国广东wechat_oa
有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期2352026-07-31T03:59:05+00:0001中国湖南wechat_oa

用途

  • 读者反馈抽样

    读一批 text,看读者对这篇文章在说什么。

  • 找出被读者认可的评论

    按 like_count 从高到低排,最前面的是点赞最多的评论。

  • 把置顶评论单独看

    is_top 标出置顶的评论,和普通评论分开读。

  • 挑出有回复的评论

    reply_count 大于 0 的评论,把它的 id 和同一个 url 交给 comment_replies 往下读。

微信公众号「查看指定文章的评论数据」接口 与 EveryInfra 对比

下面从读哪篇文章和谁能调用两方面,比较微信开放文档里「查看指定文章的评论数据」和 EveryInfra article_comments。

对比项微信公众号「查看指定文章的评论数据」接口EveryInfra
读哪篇文章请求地址带 access_token,请求体参数 msg_data_id:"群发返回的msg_data_id",index:"多图文时,用来指定第几篇图文,从0开始"。url 填 mp.weixin.qq.com 的文章自身链接,不用 msg_data_id。
谁能调用适用范围里,公众号和服务号都是 "仅认证";错误码 88000 是 "without comment privilege"。读评论不要求你是这篇文章的运营者。

引文出自微信开放文档《查看指定文章的评论数据》,页面更新日期见出处,2026-11-22 核对。 官方出处: 查看指定文章的评论数据 (更新于 2025-07-09)

限制和注意事项

  • url 必填,用 mp.weixin.qq.com 的文章自身链接:/s/<id> 短链,或带 __biz、mid、idx、sn 的链接。
  • 搜索结果里带 signature、timestamp 的临时链接可能读不了,读不了时扣费前返回 422。
  • limit 单次最多 260 条;这个能力没有翻页参数。
  • reply_count 是评论的回复数量,只是个数,回复本身要用 comment_replies 读。
  • is_top 是置顶标记,country 和 province 是评论者所在的国家和省份。

价格

每次调用 $0.006764,按次计费,不按条数算。失败和空结果不收费。

调用次数费用
10,000$67.64
100,000$676.39
1,000,000$6,763.89

合计按每次调用的标价算。

代码示例

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "wechat_oa",
  "action": "article_comments",
  "params": {
    "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

API 参考

下面是 article_comments 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「微信公众号文章评论」接口(wechat_oa/article_comments)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 wechat_oa,action 填 article_comments,参数放在 params 里。
- 必填参数:
  - url:article_comments / comment_replies / article_metrics / article_detail 使用 mp.weixin.qq.com 的文章自身链接(打开文章后复制:/s/<…
- 可选参数:
  - limit:这次调用最多返回的条数,整数,1–260;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。(默认 13)
- 返回一组记录,每条记录的主要字段:id、text、author_name、author_avatar_url(作者头像)、like_count、posted_at、is_top(是否为置顶内容)、reply_count、country、province(所在省份)。
- 示例请求体:
{
  "platform": "wechat_oa",
  "action": "article_comments",
  "params": {
    "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
  }
}
- 计费:$6.76 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是wechat_oa平台标识,固定值。
actionbodystring是article_comments能力标识,固定值。
urlbody.paramsstring是-article_comments / comment_replies / article_metrics / article_detail 使用 mp.weixin.qq.com 的文章自身链接(打开文章后复制:/s/<id> 短链,或带 __biz、mid、idx、sn 的链接);从搜索结果复制的临时链接(带 signature/timestamp)可能读不了,读不了时扣费前返回 422。账号类接口仅把它作为公众号解析的最低优先级输入。
limitbody.paramsinteger (1–260)否13这次调用最多返回的条数,整数,1–260;不传按默认值,实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

#
2026年10月25日 02:28(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息,列表只保留前 2 条;id、billing、quota 每次调用都不同,只给结构。
json
{  "id": "req_…",  "platform": "wechat_oa",  "action": "article_comments",  "results": [    {      "id": "•••",      "text": "我曾经因为不刮腋毛被朋友说“恶心”。。。。。\n不知道哪里来的这种审美捆绑。。。。。。\n谢谢丁香为我正名!!!!!",      "author_name": "•••",      "author_avatar_url": "https://wx.qlogo.cn/•••",      "like_count": 1056,      "posted_at": "2026-07-31T03:59:18+00:00",      "is_top": 0,      "reply_count": 4,      "country": "中国",      "province": "广东",      "platform": "wechat_oa"    },    {      "id": "•••",      "text": "有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期",      "author_name": "•••",      "author_avatar_url": "https://wx.qlogo.cn/•••",      "like_count": 235,      "posted_at": "2026-07-31T03:59:05+00:00",      "is_top": 0,      "reply_count": 1,      "country": "中国",      "province": "湖南",      "platform": "wechat_oa"    }  ],  "count": 20,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
text正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
author_name作者昵称(显示名)。
author_avatar_url作者头像。
like_count点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
posted_at发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
is_top是否为置顶内容。
reply_count回复数,通常用于评论的子回复。null 表示不公开。
country国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
province所在省份。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

常见问题

什么样的 url 能读到评论?

用打开文章后复制的链接:/s/<id> 短链,或带 __biz、mid、idx、sn 的链接。从搜索结果复制的临时链接带 signature 和 timestamp,可能读不了,读不了时会在扣费前返回 422。

一次能拿多少条评论?

默认只给 13 条,做舆情抽样时记得把 limit 调大,单次上限是 260 条。like_count 为 null 表示不公开,不等于 0,按点赞排序前先把 null 单独处理。

评论回复那个接口里有 is_top 和 reply_count 吗?

没有。这两项是文章评论独有的:is_top 标是否置顶,reply_count 通常用于评论的子回复数,null 表示不公开。评论回复那个接口换成了评论者的城市。

文章评论返回哪些字段?

id、text、author_name、author_avatar_url、like_count、posted_at、is_top、reply_count、country、province。

读一篇文章的评论要多少钱?

每次 $0.006764,每千次 $6.76,按调用次数算,不按条数算。失败和空结果不收费。

同一把 Key 还能调用微信公众号的其他能力。

Google Analytics 同意才加载 隐私