<p class="crumbs"><a href="/zh/apis/">数据接口</a> / <a href="/zh/apis/wechat_mp/">微信公众号</a></p>

# 公众号文章阅读数和互动 API

一篇公众号文章的阅读数、点赞数、在看数、分享数、收藏数和评论数。

| 项目 | 值 |
| --- | --- |
| 地址 | `GET https://api.feedmcp.com/v1/wechat_mp/articles/stats` |
| ID | `wechat_mp.articles.stats` |
| 价格 | **$0.02** / 次 |
| 返回 | 一个 文章互动数据对象 |
| 认证 | `Authorization: Bearer $FEEDMCP_API_KEY` |

> 微信接口响应较慢，一般 3–10 秒，客户端超时请设到 30 秒。

## 参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `url` | string | 是 | 文章链接 |

所有接口还支持 `view=full`：在返回里附上平台的原始数据（`raw`），价格不变。

## 返回字段

`data.item` 是一个「文章互动数据」对象，所有平台字段相同：

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 平台 |
| `url` | string | 文章链接 |
| `reads` | number \| null | 阅读数 |
| `likes` | number \| null | 点赞数 |
| `wows` | number \| null | 「在看」数 |
| `shares` | number \| null | 分享数 |
| `favorites` | number \| null | 收藏数 |
| `comments` | number \| null | 留言数 |

## 什么时候扣费

成功取到数据一次 $0.02。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

每次返回的 `meta.billing` 里写着这次扣了多少、还剩多少余额。

## 调用示例

### cURL

```bash
curl "https://api.feedmcp.com/v1/wechat_mp/articles/stats?url=https%3A%2F%2Fmp.weixin.qq.com%2Fs%2Fxxxxxxxx" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"
```

### Python

```python
import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/wechat_mp/articles/stats",
    params={"url": "https://mp.weixin.qq.com/s/xxxxxxxx"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())
```

### JavaScript

```js
const res = await fetch("https://api.feedmcp.com/v1/wechat_mp/articles/stats?url=https%3A%2F%2Fmp.weixin.qq.com%2Fs%2Fxxxxxxxx", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());
```

### MCP

在装好 FeedMCP 的 AI 里，调用 `call` 工具：

```json
{
  "endpoint": "wechat_mp.articles.stats",
  "params": {
    "url": "https://mp.weixin.qq.com/s/xxxxxxxx"
  },
  "max_price": "0.02"
}
```

## 返回示例

示例数据是虚构的，格式和真实返回一致。

```json
{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "item": {
      "platform": "wechat_mp",
      "url": "https://mp.weixin.qq.com/s/xxxxxxxx",
      "reads": 15234,
      "likes": 356,
      "wows": 210,
      "shares": 98,
      "favorites": 77,
      "comments": 41
    }
  },
  "page": null,
  "warnings": [],
  "meta": {
    "endpoint": "wechat_mp.articles.stats",
    "platform": "wechat_mp",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.02",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}
```

出错时的格式见 [错误码](/zh/docs/errors/)：每个错误都写明扣没扣钱（`charged`）和能不能重试（`retry`）。

## 微信公众号的其他接口

- [公众号文章全文](/zh/apis/wechat_mp/articles/get/)：$0.02
- [公众号文章留言](/zh/apis/wechat_mp/articles/comments/list/)：$0.02
- [公众号资料](/zh/apis/wechat_mp/accounts/get/)：$0.02
- [公众号历史文章](/zh/apis/wechat_mp/accounts/articles/list/)：$0.02
- [公众号留言的回复](/zh/apis/wechat_mp/articles/comments/replies/list/)：$0.02
- [公众号文章搜索](/zh/apis/wechat_mp/articles/search/)：$0.02
- [公众号主体信息](/zh/apis/wechat_mp/accounts/owner/get/)：$0.10

## 常见问题

### 公众号文章阅读数和互动接口多少钱？

成功取到数据一次 $0.02。对象不存在、没取到数据、参数错误、平台出错、超时都不收费。

### 需要平台账号吗？

不需要，只取公开数据。

### ID 或链接怎么找？

文章用 mp.weixin.qq.com 的文章链接；公众号用 gh_ 开头的原始 ID 或微信号。

### 怎么在 AI 里用？

装好 [MCP](/zh/mcp/) 后直接说你要什么，AI 会调用 `wechat_mp.articles.stats`。

---

网页版: https://feedmcp.com/zh/apis/wechat_mp/articles/stats/
