API Platform

Wechat_mp API 文档

按接口查看 TRMesh 对外路径、用途说明、价格、默认 RPS 和接入方式。

11API 数量
3能力分类
Token统一鉴权
POSTAccount
/api/v1/wechat_mp/v2/fetch_account_articles

获取公众号文章列表

传 gh_username,返回公众号历史发文(**文章** tab)的**单页**列表。 **手动翻页**:首页 offset 留空 → 从响应取 next_offset(base64 游标)→ 下次请求放进 **offset** 取下一页;is_end 为真即末页。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

POSTAccount
/api/v1/wechat_mp/v2/fetch_account_profile

获取公众号资料页

传公众号 username,返回公众号资料页:昵称 / IP 属地 / 原创文章数 / 认证主体类型 / 关联视频号等。 ⚠️ **签名(简介)与头像这条路取不到** —— 微信的资料页响应里既没有可读简介也没有头像。 它们恒为 null 并列在 $.data.unavailable[] 里,**不会用空串冒充**,调用方可据此区分 「这个号真的没填」和「这条路取不到」。 💡 **头像请改用 /fetch_article_detail_h5**(传该号的任意一篇文章链接,raw=true): $.data.content.round_head_img(普通)/ $.data.content.hd_head_img(高清)。 那条路确实有值,已实测。简介目前没有任何接口能取到。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

POSTAccount
/api/v1/wechat_mp/v2/fetch_account_services

获取公众号服务

传 gh_username,返回公众号底部的自定义菜单 / 服务入口。未配置自定义菜单的账号返回空菜单。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

POSTData
/api/v1/wechat_mp/v2/fetch_article_ad

获取公众号文章广告

传文章 URL,返回文章内嵌的广告位信息。该接口响应相对较慢,请耐心等待;未投放广告的文章返回空。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

POSTComments
/api/v1/wechat_mp/v2/fetch_article_comments

获取公众号文章评论

获取公众号文章评论(单页,buffer 游标翻页),返回文章的一页精选评论。 **翻页**:首页 buffer 留空 → 取响应的 buffer → 下次请求传回 buffer 取下一页;has_more 为 false 即到末页。 逐条评论的二级回复请用 fetch_comment_replies(传评论的 content_id)。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。 ⚠️ 大整数 ID 精度:响应中的 content_id 等为 64 位大整数,超出 JavaScript 安全整数范围(2^53-1)。请始终以**字符串**方式接收 / 传递这类 ID(解析 JSON 用 json-bigint 或按文本取值),勿让其经过 JS Number。Swagger UI 文档页对超大整数会末位舍入显示,属正常现象,不影响接口实际返回的数据。 💡 **提速**:传 comment_id 可让数据服务跳过整篇文章的抓取解析,实测本接口从 15.10s 降到 6.91s / 评论接口从 8.28s 降到 6.13s。该值取自 /fetch_article_detail 或 /fetch_article_detail_h5 响应的 $.data.content.comment_id,拿它是零成本的。

POSTData
/api/v1/wechat_mp/v2/fetch_article_detail

获取公众号文章详情

传文章 URL,返回文章正文 / 标题 / 作者 / 封面 / 发布时间 / 合集信息等。 无论 raw 取值,嵌套的 content JSON 串都会被解析成对象(结构归一化),raw 只控制外层字段的投影范围。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。 ⚠️ 大整数 ID 精度:响应中的 comment_id / msgId 等为 64 位大整数,超出 JavaScript 安全整数范围(2^53-1)。请始终以**字符串**方式接收 / 传递这类 ID(解析 JSON 用 json-bigint 或按文本取值),勿让其经过 JS Number。Swagger UI 文档页对超大整数会末位舍入显示,属正常现象,不影响接口实际返回的数据。

POSTData
/api/v1/wechat_mp/v2/fetch_article_detail_h5

获取公众号文章详情(H5 版本,推荐)

传文章 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。

POSTData
/api/v1/wechat_mp/v2/fetch_article_stats

获取公众号文章互动数据

传文章 URL,返回文章的互动指标(阅读量 / 点赞 / 在看 / 分享 / 收藏 / 评论数)。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

POSTData
/api/v1/wechat_mp/v2/fetch_article_stats_h5

获取公众号文章互动数据(H5 版本)

传文章 URL,返回**评论数 / 精选评论数**。与 /fetch_article_stats 是**两个独立接口**, 各自返回结果,不会自动切换: | 接口 | 能取到 | 建议 | |---|---|---| | /fetch_article_stats | 阅读量 / 点赞 / 在看 / 分享 / 收藏 / 评论数(**全部指标**) | 需要阅读量等指标时用 | | /fetch_article_stats_h5(本接口) | **仅评论数 / 精选评论数**;稳定性更好 | 只要评论数、或上面那条报错时用 | ⚠️ 阅读量、点赞、在看、分享、收藏这几项**本接口取不到**,一律返回 null 并列在 $.data.unavailable[],**不会用 0 冒充** —— 调用方可据此区分「这篇文章真的是 0」 和「这条路取不到」。需要这些指标请用 /fetch_article_stats。 价格:0.01$/次 ⏱️ 请将客户端超时(timeout)设置为 30 秒。 ⚠️ 大整数 ID 精度:comment_id / appmsgid 为 64 位大整数,请以**字符串**方式接收 / 传递。 💡 **提速**:传 comment_id 可让数据服务跳过整篇文章的抓取解析,实测本接口从 15.10s 降到 6.91s / 评论接口从 8.28s 降到 6.13s。该值取自 /fetch_article_detail 或 /fetch_article_detail_h5 响应的 $.data.content.comment_id,拿它是零成本的。

POSTComments
/api/v1/wechat_mp/v2/fetch_comment_replies

获取公众号评论的二级回复

返回某条一级评论下的二级回复。 链路:先调 fetch_article_comments 取到每条评论的 content_id,再把它喂给本接口。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。 ⚠️ 大整数 ID 精度:响应中的 content_id / reply_id 等为 64 位大整数,超出 JavaScript 安全整数范围(2^53-1)。请始终以**字符串**方式接收 / 传递这类 ID(解析 JSON 用 json-bigint 或按文本取值),勿让其经过 JS Number。Swagger UI 文档页对超大整数会末位舍入显示,属正常现象,不影响接口实际返回的数据。 💡 **提速**:传 comment_id 可让数据服务跳过整篇文章的抓取解析,实测本接口从 15.10s 降到 6.91s / 评论接口从 8.28s 降到 6.13s。该值取自 /fetch_article_detail 或 /fetch_article_detail_h5 响应的 $.data.content.comment_id,拿它是零成本的。

POSTData
/api/v1/wechat_mp/v2/fetch_related_articles

获取公众号关联文章

传文章 URL,返回文章底部「关联 / 相关文章」。未开启该功能的文章返回空列表。 价格:0.01$/次 ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。