微信公众号普通文章与贴图:正文、图片、评论和统计怎么获取
普通文章与贴图共用文章详情、评论和统计接口,但正文形态不同。本文说明如何保留图片顺序、区分评论总数与当前页条数,以及正确处理不可用的统计字段。
普通文章与贴图分别返回什么
输入微信公众号文章链接或包含链接的分享文案,详情接口返回标题、账号、发布时间、正文纯文本 content_text、正文 HTML content_html,以及按页面顺序排列的 image_urls。
普通文章通常以文字和正文内图片为主;贴图的主要信息可能在图片中。纯文本正文不包含图片文字识别结果,不能只读 content_text 就认为已经理解全部内容。封面字段 cover_image_url 也不能代替正文图片列表。
转载卡片页返回当前公众号的推荐语与原文卡片,linked_articles 提供原文入口;读取当前页不会自动读取原文全文。
一个包含六张图片的已验证样本
2026 年 10 月 30 日的验证样本为《GPT-6的GoogleSEO水平已经无人能敌》,作者为 Prompt神棍。该页面为贴图形态,详情应保留六张有序图片及页面文字;本次能力说明引用已有验证记录,并非重新查询实时统计。
这个样本说明了一个常见误区:能拿到标题和文字,不代表已经读取贴图中的完整信息。阅读这类文章时,需要继续查看 image_urls 对应图片。六张是此样本的结果,不是所有文章的固定图片数量。
最小操作示例:同一链接读取详情、评论和统计
以下命令适用于 Bash/zsh 终端。先在后台取得 API Key,并在当前终端设置 SOCIALDATAX_API_KEY。下面以已有的微信公众号样本链接演示三个独立请求,可按需要分别执行;成功调用才计费。示例使用当前公开接口参数,本次没有重新请求样本或更新其统计数值。
先读取详情,按 image_urls 的数组顺序查看正文图片;需要评论或统计时,再执行后两条请求。每次请求都保留同一篇文章链接。
# 先在当前终端设置 SOCIALDATAX_API_KEY;以下三次成功调用合计 30 积分。
# 1. 读取详情和正文图片
curl --request POST \
'https://mcp.socialdatax.com/socialdatax/api/v1/wechat/mp/article/detail' \
--header "Authorization: Bearer $SOCIALDATAX_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{"url":"https://mp.weixin.qq.com/s/KtzxbkPn1Rzd3waqQ09xbQ"}'
# 2. 读取第一页可见评论
curl --request POST \
'https://mcp.socialdatax.com/socialdatax/api/v1/wechat/mp/article/comment/list' \
--header "Authorization: Bearer $SOCIALDATAX_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{"url":"https://mp.weixin.qq.com/s/KtzxbkPn1Rzd3waqQ09xbQ","page_token":""}'
# 3. 读取当前互动统计
curl --request POST \
'https://mcp.socialdatax.com/socialdatax/api/v1/wechat/mp/article/stats' \
--header "Authorization: Bearer $SOCIALDATAX_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{"url":"https://mp.weixin.qq.com/s/KtzxbkPn1Rzd3waqQ09xbQ"}'
- 详情:读取 title、content_text、content_html 和 image_urls。已有验证记录中,这个样本返回六张有序图片;实际使用时以本次返回为准。
- 评论:首页 page_token 留空。需要下一页时,把 next_page_token 原样作为新的 page_token;为空则停止。后续每页另计费。
- 统计:读取 like_count、recommend_count、comment_count 等字段;null 表示当前不可用,不要改写为 0。查询时间也应一起记录。
统计字段不可用时,不要记为零
统计接口单独返回阅读、点赞、推荐、分享、收藏和评论数。recommend_count 是推荐数(爱心,原在看),与 like_count 点赞数不同。
统计字段当前不可用时为 null;0 表示返回的数值为零。做表格或报告时应保留区别,并记录查询时间。不同时间的统计快照可能变化,不宜与旧截图直接判定一致性。
从搜索继续到账号发布列表
普通文章搜索与贴图搜索是不同入口;从结果取 article_url 后,可衔接同一套详情、评论和统计接口。搜索卡片可能包含正文片段,精确标题与发布时间以详情为准。
需要继续了解发布账号时,从详情的 account.account_id 读取账号资料,再根据目标选择账号文章列表或账号贴图列表。不要用账号名称替代账号 ID,也不要混用不同搜索和列表的分页令牌。
接入与调用成本
使用 API 或 AI 接入需要社媒数据助手 API Key 和可用额度。详情、评论、回复、统计和每次翻页分别计费,不是一条链接只计费一次。
截至本文核对时,公开 catalog 中文章详情、一级评论和统计接口均为成功调用每次 10 积分,1 积分为 0.01 元;三项各成功调用一次共 30 积分(0.30 元),不含搜索、回复和翻页。价格可能调整,以当前接口说明及实际返回 points.cost 为准。
以上是能力与样本说明,不承诺任意文章始终可访问、返回所有历史评论或提供平台未公开的指标。
评论需要单独读取,并保留分页上下文
普通文章和贴图均使用文章评论接口读取可见一级评论,回复由评论回复接口读取。详情正文不包含完整评论列表。
将返回的 next_page_token 原样传回 page_token,保持文章链接不变;令牌为空时停止。当前文档要求在 3 天内继续翻页,令牌失效后从首页重新获取。
items 是当前页一级评论,comment_count 是文章留言总数,可能包含回复;两者不能直接比较。接口成功但当前页为空,不足以证明文章没有任何留言,也不表示能读取平台未公开的评论。