WeChat-Media-Platform-V2-API

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

Changed on

[中文]

用途:

  • 传文章 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
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)
  • Auth
    HTTP bearer

Request body

urlstring required

公众号文章链接(https://mp.weixin.qq.com/s/… 或带 __biz 的长链)/WeChat MP article URL (https://mp.weixin.qq.com/s/… or long URL with __biz)

rawboolean

True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure

Example request

{
  "url": "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes