文章详情(含阅读数) API
用公众号文章链接查正文,并同时返回阅读数和点赞数。缺其中一项则调用失败、不扣费。
查询一篇公众号文章的正文,并同时给出阅读数和点赞数。文章链接、等价的 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_id | string | 公众号 ID。没有时为空。 |
account_name | string | 公众号名称。没有时为空。 |
article_id | string | 文章 ID。 |
author | string | 作者署名。没有时为空。 |
content | string | 正文。 |
cover_url | string | 封面地址。没有封面时为空。 |
digest | string | 摘要。没有时为空。 |
like_num | number | 点赞数。本接口成功时一定有值。 |
publish_time | string | 发布时间。 |
read_num | number | 阅读数。本接口成功时一定有值。 |
source | string | 来源名称。没有时为空。 |
title | string | 标题。没有标题时为空。 |
url | string | 页面链接。 |
调用示例
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 的文章地址。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 和文章详情有什么差别?
- 本接口在正文之外保证读到 read_num 和 like_num。缺其中一项就整次失败。
- article_id 怎么取?
- 文章链接 /s/ 后面那段。有完整链接时传 url 更稳。
- 调用失败会扣费吗?
- 只有调用成功才扣费。参数错误、对象不存在或取数失败不扣费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案