---
title: "获取公众号文章互动数据/Get WeChat MP Article Stats"
method: POST
path: "/api/v1/wechat_mp/v2/fetch_article_stats"
tags: ["WeChat-Media-Platform-V2-API"]
---

# 获取公众号文章互动数据/Get WeChat MP Article Stats

`POST /api/v1/wechat_mp/v2/fetch_article_stats`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/wechat_mp/v2/fetch_article_stats`
- Auth: HTTP bearer

# [中文]
### 用途:
- 传文章 URL，返回文章的互动指标（阅读量 / 点赞 / 在看 / 分享 / 收藏 / 评论数）。
- 价格：0.01$/次
- ⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。
### 参数:
- url: 公众号文章链接（`https://mp.weixin.qq.com/s/…`）。示例 `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`
- raw: 可选，默认 True。True=完整原始统计对象（含 `show_*` 显隐标志位）；False=仅精简计数。
### 返回:
- 文章互动数据

### 响应结构与 JSON Path:
#### `raw=false`（精简计数）:
- `data` 为 7 个计数字段:
    - `$.data.read_num`: 阅读量
    - `$.data.like_count`: 点赞数
    - `$.data.old_like_count`: 在看数（旧「在看」）
    - `$.data.share_count`: 分享数
    - `$.data.collect_count`: 收藏数
    - `$.data.comment_count`: 评论数
    - `$.data.star_num`: 星标 / 喜欢数
#### `raw=true`（原始）:
- `data` 为完整原始统计对象：含 `raw=false` 的全部计数（同名同义），外加显隐 / 状态标志位:
    - 计数: `$.data.read_num` / `$.data.like_count` / `$.data.old_like_count` / `$.data.share_count` / `$.data.collect_count` / `$.data.comment_count` / `$.data.star_num`
    - 显隐标志: `$.data.show_like` / `$.data.show_old_like` / `$.data.show_share` / `$.data.show_collect` / `$.data.show_read` / `$.data.show_star`（及对应 `*_gray` 置灰位）
    - 状态: `$.data.comment_enabled`（评论开关）/ `$.data.get_data_succ`（取数成功）/ `$.data.is_subscribed` / `$.data.verify_status` / `$.data.can_use_star`

# [English]
### Purpose:
- Pass an article URL to get its interaction metrics (reads / likes / "wow" / shares / favorites / comments).
- Price: $0.01 per request
- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.
### Parameters:
- url: WeChat MP article URL (`https://mp.weixin.qq.com/s/…`). E.g. `https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw`
- raw: Optional, default True. True=full raw stats object (with `show_*` visibility flags); False=simplified counts only.
### Return:
- Article interaction stats

### Response structure & JSON Path:
#### `raw=false` (simplified counts):
- `data` contains 7 count fields:
    - `$.data.read_num`: read count
    - `$.data.like_count`: like count
    - `$.data.old_like_count`: "wow" count (old "Looking")
    - `$.data.share_count`: share count
    - `$.data.collect_count`: favorite count
    - `$.data.comment_count`: comment count
    - `$.data.star_num`: star / like count
#### `raw=true` (raw):
- `data` is the full raw stats object: all counts of `raw=false` (same names and meanings), plus visibility / status flags:
    - Counts: `$.data.read_num` / `$.data.like_count` / `$.data.old_like_count` / `$.data.share_count` / `$.data.collect_count` / `$.data.comment_count` / `$.data.star_num`
    - Visibility flags: `$.data.show_like` / `$.data.show_old_like` / `$.data.show_share` / `$.data.show_collect` / `$.data.show_read` / `$.data.show_star` (and corresponding `*_gray` flags)
    - Status: `$.data.comment_enabled` (comment switch) / `$.data.get_data_succ` (fetch success) / `$.data.is_subscribed` / `$.data.verify_status` / `$.data.can_use_star`

## Request body

- FetchArticleDetailRequest
  - `url` string, required: 公众号文章链接（https://mp.weixin.qq.com/s/… 或带 __biz 的长链）/WeChat MP article URL (https://mp.weixin.qq.com/s/… or long URL with __biz)
  - `raw` boolean: True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/wechat_mp/v2/fetch_article_stats/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)