欢迎访问极媒数据 · 新媒体数据服务平台 登录 免费注册 控制台
新媒体数据
服务平台
首页接口文档微信公众号文章详情(含阅读数)

文章详情(含阅读数) API

微信公众号¥0.60/次每分钟 60 次

用公众号文章链接查正文,并同时返回阅读数和点赞数。缺其中一项则调用失败、不扣费。

查询一篇公众号文章的正文,并同时给出阅读数和点赞数。文章链接、等价的 article_url,或链接 /s/ 后的 article_id,三选一。

阅读数或点赞数缺任何一个,这次调用失败,不扣费。只要正文、不看阅读数时用文章详情。

请求地址 POST https://www.xmedi.cn/api/v1/wechat/articles/detail-pro。调用成功才扣费,参数错误、平台侧失败或超时不扣费。

成功响应的 meta 含数据血缘,说明见 鉴权与计费。

适用场景

  • 报送:一篇稿同时要正文、阅读和点赞,避免两次查询对不上。
  • 复盘:read_num 和 like_num 写入同一行。
  • 失败处理:缺数时整单失败,不要把阅读数记成 0。

请求参数

字段类型必填说明
article_id string 否 文章 sn(链接 /s/ 后那段),平台会补成完整链接。与 url、article_url 任选其一。
article_url string 否 文章链接,与 url 等价。与 url、article_id 任选其一。
url string 否 文章链接(https://mp.weixin.qq.com/s/… 或带 __biz 的长链)。与 article_url、article_id 任选其一。

返回 data 字段

字段类型说明
account_idstring公众号 ID。没有时为空。
account_namestring公众号名称。没有时为空。
article_idstring文章 ID。
authorstring作者署名。没有时为空。
contentstring正文。
cover_urlstring封面地址。没有封面时为空。
digeststring摘要。没有时为空。
like_numnumber点赞数。本接口成功时一定有值。
publish_timestring发布时间。
read_numnumber阅读数。本接口成功时一定有值。
sourcestring来源名称。没有时为空。
titlestring标题。没有标题时为空。
urlstring页面链接。

调用示例

curl -X POST https://www.xmedi.cn/api/v1/wechat/articles/detail-pro \
  -H "X-XMEDI-Key: xm_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"http://mp.weixin.qq.com/s?__biz=MjM5MjAxNDM4MA==\u0026mid=2667026902\u0026idx=1\u0026sn=625cd9b1604b0968a3dcb98380a931ff"}'

调试

返回示例

以下为 data 的字段结构示意,实际取值以调用结果为准。

{
  "account_id": "gh_example",
  "account_name": "示例公众号",
  "article_id": "exampleSn",
  "author": "示例作者",
  "content": "示例正文",
  "cover_url": "https://example.com/cover.jpg",
  "digest": "示例摘要",
  "like_num": 20,
  "publish_time": "2026-01-01T00:00:00Z",
  "read_num": 1000,
  "source": "示例公众号",
  "title": "示例标题",
  "url": "https://mp.weixin.qq.com/s/exampleSn"
}

注意事项

  • 缺阅读数或点赞数时不扣费。
  • 本接口比只取正文的文章详情更贵。链接需是 mp.weixin.qq.com 的文章地址。

常见错误码

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

常见问题

和文章详情有什么差别?
本接口在正文之外保证读到 read_num 和 like_num。缺其中一项就整次失败。
article_id 怎么取?
文章链接 /s/ 后面那段。有完整链接时传 url 更稳。
调用失败会扣费吗?
只有调用成功才扣费。参数错误、对象不存在或取数失败不扣费。

相关接口

需要接入这个接口?

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

免费注册
×

微信号 xmedi369