WeChat-Media-Platform-V2-API

获取公众号文章详情(H5 版本,推荐)/Get WeChat MP Article Detail (H5, Recommended)

Changed on

[中文]

用途:

  • 传文章 URL,返回文章正文 / 标题 / 作者 / 封面 / 发布时间 / 合集信息等,推荐默认使用本接口。

  • 与 /fetch_article_detail 是两个独立接口,各自返回结果,不会自动切换:

    接口特点建议
    /fetch_article_detail响应快、字段较少;稳定性不如本接口对速度敏感时用
    /fetch_article_detail_h5(本接口)正文稳定、字段最全默认推荐
  • 返回结构与 /fetch_article_detail 对齐(data 为 {url, bizUin, itemIdx, content}), 按 content 取值的调用方无需改代码即可切换。

  • 价格:0.01$/次

  • ⏱️ 本接口需拉取并解析文章页面,响应比原生版本慢,请将客户端超时(timeout)设置为 30 秒。

  • ⚠️ 大整数 ID 精度:comment_id / mid 等为 64 位大整数,超出 JavaScript 安全整数范围(2^53-1)。 请始终以字符串方式接收 / 传递(解析 JSON 用 json-bigint),勿让其经过 JS Number。

  • 阅读量与评论列表两个详情接口都不返回:互动数据用 /fetch_article_stats 或 /fetch_article_stats_h5,评论用 /fetch_article_comments。

参数:

  • url: 公众号文章链接(https://mp.weixin.qq.com/s/… 或带 __biz 的长链)。
  • raw: 可选,默认 True。True=附带更多元字段(头像 / 版权 / 页面体积);False=仅核心字段。 两者顶层结构一致,raw 只增减 content 内字段。

返回:

  • 文章详情(正文 / 标题 / 作者 / 封面 / 发布时间 / 合集 / 标签 / IP 属地 / 图片清单等)

响应结构与 JSON Path:

raw=false(核心字段):

  • data 顶层 4 个字段,正文与元信息聚合在 content:
    • $.data.url: 文章 URL
    • $.data.bizUin: 公众号 bizUin(int,由 __biz 解码)
    • $.data.itemIdx: 图文位置序号(int)
    • $.data.content: 解析出的文章对象,常用路径:
      • $.data.content.title: 标题
      • $.data.content.nick_name / $.data.content.user_name: 公众号名 / gh_username 或 wxid
      • $.data.content.author: 作者
      • $.data.content.desc: 摘要
      • $.data.content.create_time: 发布时间("2026-05-24 11:35" 文本)
      • $.data.content.create_timestamp / $.data.content.ori_create_time: 发布时间戳(int 秒)
      • $.data.content.cdn_url: 封面图
      • $.data.content.mid / $.data.content.idx / $.data.content.sn: 图文 id / 位置 / 校验串
      • $.data.content.comment_id: 评论 id(喂评论接口的内部 id;沉浸 / 图片页可能为空)
      • $.data.content.source_url: 原文链接(无则空串)
      • $.data.content.link: 文章长链
      • $.data.content.content_noencode: 正文 HTML(_content_type=article 时有,其它形态为空)
      • $.data.content.content_text: 正文纯文字
      • $.data.content._content_type: 文章形态(article 经典图文 / immersive 沉浸图片页 / video 视频页 / unknown 未识别形态,正文即摘要)

raw=true(附带更多元字段):

  • data 顶层同 raw=false;content 在上表基础上再加:
    • $.data.content.round_head_img / $.data.content.hd_head_img: 公众号头像(普通 / 高清)
    • $.data.content.copyright_stat: 原创声明状态
    • $.data.content.html_size: 拉取到的文章 HTML 字符数(len 长度,非字节)

[English]

Purpose:

  • Fetch WeChat MP article detail via the H5 channel. Recommended by default: the body is more reliable and the field coverage is the widest.
  • Independent from /fetch_article_detail; neither falls back to the other.
  • Price: 0.01$/request

Parameters:

  • url: WeChat MP article URL.
  • raw: Optional, default True. True = extra meta fields; False = core fields only. Top-level shape is identical either way.

Returns:

  • Article detail (title / author / cover / publish time / album / tags / images ...)
post/api/v1/wechat_mp/v2/fetch_article_detail_h5

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