---
title: "获取公众号文章详情（H5 版本，推荐）/Get WeChat MP Article Detail (H5, Recommended)"
method: POST
path: "/api/v1/wechat_mp/v2/fetch_article_detail_h5"
tags: ["WeChat-Media-Platform-V2-API"]
---

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

`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)
- URL: `https://api.tikhub.io/api/v1/wechat_mp/v2/fetch_article_detail_h5`
- Auth: HTTP bearer

# [中文]
### 用途:
- 传文章 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 ...)

## 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-08** `485e774cb449`: 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_detail_h5/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)