社交内容 · 数据 API

微信公众号 API

Q: 微信公众号 API 怎么收费？

$5.56 / 千次，微信公众号 全部 12 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 179 次 微信公众号 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Q: 微信公众号 API 一次能返回多少条数据？

微信公众号 有 7 个列表接口，包括 article_search、account_search、mini_program_search、account_articles、account_today_articles、article_comments、comment_replies。其余 5 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Q: 可以先免费试用 微信公众号 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 微信公众号 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 12 个能力。无需信用卡。

查询公众号文章线索、账号资料与主体信息，读取文章留言及阅读、点赞、在看计数；关键词还可用于微信指数查询，供整理内容与观察热度。调用 POST /api/v1/social ；返回结构化 JSON，$5.56 / 千次；失败不计费。

免费开始看文档

个能力

$5.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

微信公众号能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
article_search	keyword	category, sub_type	默认 20 · 最多 400	同步	$5.56 / 千次	id · title · summary · url · cover_image_url · account_name · posted_at · relative_time · kind · platform
account_search	keyword	—	默认 20 · 最多 400	同步	$5.56 / 千次	account_id · ghid · name · description · alias · avatar_url · verify_flag · biz · platform
mini_program_search	keyword	—	默认 20 · 最多 400	同步	$5.56 / 千次	id · name · description · icon_url · username · is_minigame · platform
search_suggestions	keyword	—	—	同步	$5.56 / 千次	suggestions · count · platform
account_profile	account	—	—	同步	$5.56 / 千次	account_id · name · account_type · description · avatar_url · biz · platform
account_principal	account	—	—	同步	$5.56 / 千次	account_id · ghid · name · description · company_name · owner_name · customer_type · verify_status · verify_type · verified_at · registered_country · registered_at · is_overseas · last_login_province · authorized_agents · platform
account_articles	account	—	默认 8 · 最多 160	同步	$5.56 / 千次	id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform
account_today_articles	account	—	—	同步	$5.56 / 千次	id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform
article_comments	url	—	默认 13 · 最多 260	同步	$5.56 / 千次	id · text · author_name · author_avatar_url · like_count · posted_at · is_top · reply_count · country · province · platform
comment_replies	url, comment_id	content_id	—	同步	$5.56 / 千次	id · text · author_name · author_avatar_url · like_count · posted_at · country · province · city · platform
article_metrics	url	—	—	同步	$5.56 / 千次	read_count · like_count · watching_count · share_count · collect_count · comment_count · platform
wechat_index	keyword	—	—	同步	$5.56 / 千次	keyword · latest_index · latest_date · data_points · trend · platform

微信公众号每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用微信公众号文章搜索 API？

article_search

使用 platform="wechat_oa"、action="article_search" 调用“文章搜索”能力；返回列表，默认 20 条、单次最多 400 条，主要包含 id、title、summary、url、cover_image_url、account_name 等 10 个字段。

微信公众号 article_search 的参数分别是什么意思？

keyword必填: article_search 搜文章，account_search 搜公众号，mini_program_search 搜小程序，search_suggestions 取联想词，wechat_index 取关键词指数；这些都不是个人微信聊天搜索。
category可选: 仅 article_search 的文章栏目：ALL 全部、LATEST 最新、HOT 热门、FOLLOWED 已关注、RECENT_READ 最近读过；后两项与用户状态相关，当前没有传入你的微信登录态，不保证可用，也不会读取你的个人关注/阅读记录。
sub_type可选: category 的兼容字段，同样使用五个文章栏目值，传入会转大写；两者同时出现时 category 优先。

微信公众号特有返回字段与含义（5）

account_name: 公众号名称。
cover_image_url: 封面图。
summary: 摘要。
relative_time: 相对时间描述（如「3天前」）。
kind: 条目类别。

怎么调用微信公众号公众号搜索 API？

account_search

使用 platform="wechat_oa"、action="account_search" 调用“公众号搜索”能力；返回列表，默认 20 条、单次最多 400 条，主要包含 account_id、ghid、name、description、alias、avatar_url 等 9 个字段。

微信公众号 account_search 的参数分别是什么意思？

keyword必填: article_search 搜文章，account_search 搜公众号，mini_program_search 搜小程序，search_suggestions 取联想词，wechat_index 取关键词指数；这些都不是个人微信聊天搜索。
微信将 nick_name、alias、user_name 分别说明为昵称、公众号所设置的微信号、原始 ID，微信号可能为空。本页搜索结果的 name、account_id 与 ghid 应分别核对，不把三者当同一个字符串。官方来源：微信：公众号昵称、微信号与原始 ID来源核查：2026-09-04

微信公众号特有返回字段与含义（5）

account_id: 公众号 ID。
ghid: 同 account_ghid。
biz: 公众号的 __biz 参数，文章链接里带的标识。
alias: 公众号自定义的微信号。
verify_flag: 认证标记。

怎么调用微信公众号小程序搜索 API？

mini_program_search

使用 platform="wechat_oa"、action="mini_program_search" 调用“小程序搜索”能力；返回列表，默认 20 条、单次最多 400 条，主要包含 id、name、description、icon_url、username、is_minigame 等 7 个字段。

腾讯 2017 年第二季度官方业绩材料明确提到微信以关键词和定位搜索扩展小程序入口；该历史材料只支撑“小程序可由关键词发现”的对象关系，不是当前开放 API，也不证明 EveryInfra 的 20 条上限、字段、排序、完整性或生产可用性。官方来源：腾讯：关键词搜索可连接小程序来源核查：2026-09-05

微信公众号 mini_program_search 的参数分别是什么意思？

keyword必填: article_search 搜文章，account_search 搜公众号，mini_program_search 搜小程序，search_suggestions 取联想词，wechat_index 取关键词指数；这些都不是个人微信聊天搜索。

微信公众号特有返回字段与含义（2）

icon_url: 公众号头像。
is_minigame: 是否为小游戏关联账号。

怎么调用微信公众号搜索联想 API？

search_suggestions

使用 platform="wechat_oa"、action="search_suggestions" 调用“搜索联想”能力；返回单个对象，主要包含 suggestions、count、platform。

微信公众号 search_suggestions 的参数分别是什么意思？

keyword必填: article_search 搜文章，account_search 搜公众号，mini_program_search 搜小程序，search_suggestions 取联想词，wechat_index 取关键词指数；这些都不是个人微信聊天搜索。

微信公众号特有返回字段与含义（2）

count: 数量。
suggestions: 相关推荐词。

怎么调用微信公众号公众号资料 API？

account_profile

使用 platform="wechat_oa"、action="account_profile" 调用“公众号资料”能力；返回单个对象，主要包含 account_id、name、account_type、description、avatar_url、biz 等 7 个字段。

微信公众号 account_profile 的参数分别是什么意思？

account必填: 公众号标识，可用微信号、gh_ 开头的原始 ID，或可解析公众号的账号/文章 URL；不是个人微信号。account_principal 取主体资料，account_articles 取历史文章列表，account_today_articles 取当日文章。
微信官方资料分别描述账号类型、认证类型和主体名称；账号展示名称不等于主体名称。这里仅核对术语，不表示已取得官方授权账号管理权限，也不将其 access_token 或 appid 复制为本接口参数。官方来源：微信：账号类型、认证类型与主体名称来源核查：2026-09-04

微信公众号特有返回字段与含义（3）

account_id: 公众号 ID。
biz: 公众号的 __biz 参数，文章链接里带的标识。
account_type: 账号类型（订阅号 / 服务号）。

怎么调用微信公众号公众号主体信息 API？

account_principal

使用 platform="wechat_oa"、action="account_principal" 调用“公众号主体信息”能力；返回单个对象，主要包含 account_id、ghid、name、description、company_name、owner_name 等 16 个字段。

微信公众号 account_principal 的参数分别是什么意思？

account必填: 公众号标识，可用微信号、gh_ 开头的原始 ID，或可解析公众号的账号/文章 URL；不是个人微信号。account_principal 取主体资料，account_articles 取历史文章列表，account_today_articles 取当日文章。
微信官方资料分别描述账号类型、认证类型和主体名称；账号展示名称不等于主体名称。这里仅核对术语，不表示已取得官方授权账号管理权限，也不将其 access_token 或 appid 复制为本接口参数。官方来源：微信：账号类型、认证类型与主体名称来源核查：2026-09-04

微信公众号特有返回字段与含义（13）

account_id: 公众号 ID。
ghid: 同 account_ghid。
customer_type: 主体类型（个人 / 企业 / 政府 / 媒体）。
company_name: 认证主体的公司名称。
owner_name: 运营者名称。
verify_status: 认证状态。
verify_type: 认证类型。
verified_at: 认证时间。
authorized_agents: 授权代理机构。
registered_at: 注册时间。
registered_country: 注册国家。
is_overseas: 是否为境外主体。
last_login_province: 最近登录省份。

怎么调用微信公众号公众号历史文章 API？

account_articles

使用 platform="wechat_oa"、action="account_articles" 调用“公众号历史文章”能力；返回列表，默认 8 条、单次最多 160 条，主要包含 id、title、url、cover_image_url、posted_at、position 等 12 个字段。

微信公众号 account_articles 的参数分别是什么意思？

account必填: 公众号标识，可用微信号、gh_ 开头的原始 ID，或可解析公众号的账号/文章 URL；不是个人微信号。account_principal 取主体资料，account_articles 取历史文章列表，account_today_articles 取当日文章。
微信官方接口支持通过本公众号 access token 获取该授权账号已成功发布的内容；官方调用对象由令牌身份决定，不接受任意 account 搜索其他公众号，因此该来源只用于说明已授权账号接口与 EveryInfra 公开账号输入不是同一访问模型。官方来源：微信公众号：已发布内容列表的授权账号边界来源核查：2026-09-05

微信公众号特有返回字段与含义（7）

account_name: 公众号名称。
cover_image_url: 封面图。
account_id: 公众号 ID。
account_ghid: 公众号的 gh_ 开头原始 ID，微信体系内的唯一标识。
is_original: 是否为原创声明文章。
is_deleted: 内容是否已被删除。
position: 排名位置。

怎么调用微信公众号公众号当日文章 API？

account_today_articles

使用 platform="wechat_oa"、action="account_today_articles" 调用“公众号当日文章”能力；返回列表，主要包含 id、title、url、cover_image_url、posted_at、position 等 12 个字段。

微信公众号 account_today_articles 的参数分别是什么意思？

account必填: 公众号标识，可用微信号、gh_ 开头的原始 ID，或可解析公众号的账号/文章 URL；不是个人微信号。account_principal 取主体资料，account_articles 取历史文章列表，account_today_articles 取当日文章。
微信官方可列出本授权公众号已发布内容，调用方可依据返回时间字段做日期处理；官方没有定义按任意公众号 account 获取今日文章的公共接口，today 是 EveryInfra 自身动作语义，不能由授权账号资料外推。官方来源：微信公众号：已发布内容与日期筛选边界来源核查：2026-09-05

微信公众号特有返回字段与含义（7）

account_name: 公众号名称。
cover_image_url: 封面图。
account_id: 公众号 ID。
account_ghid: 公众号的 gh_ 开头原始 ID，微信体系内的唯一标识。
is_original: 是否为原创声明文章。
is_deleted: 内容是否已被删除。
position: 排名位置。

怎么调用微信公众号文章评论 API？

article_comments

使用 platform="wechat_oa"、action="article_comments" 调用“文章评论”能力；返回列表，默认 13 条、单次最多 260 条，主要包含 id、text、author_name、author_avatar_url、like_count、posted_at 等 11 个字段。

微信公众号 article_comments 的参数分别是什么意思？

url必填: article_comments / comment_replies / article_metrics 使用 mp.weixin.qq.com 的具体文章链接；账号类接口仅把它作为公众号解析的最低优先级输入。
微信的留言文档区分文章、评论 ID、精选标记与回复信息。官方授权接口的后台评论范围不等于本接口可见范围，is_top 也不能直接当作官方 comment_type 的精选标记。官方来源：微信：文章评论与精选评论的区别来源核查：2026-09-04

微信公众号特有返回字段与含义（3）

province: 所在省份。
is_top: 是否为置顶内容。
author_avatar_url: 作者头像。

怎么调用微信公众号评论回复 API？

comment_replies

使用 platform="wechat_oa"、action="comment_replies" 调用“评论回复”能力；返回列表，主要包含 id、text、author_name、author_avatar_url、like_count、posted_at 等 10 个字段。

微信公众号 comment_replies 的参数分别是什么意思？

url必填: article_comments / comment_replies / article_metrics 使用 mp.weixin.qq.com 的具体文章链接；账号类接口仅把它作为公众号解析的最低优先级输入。
comment_id必填: comment_replies 的目标评论 ID，从同一文章 article_comments 的评论结果获取；必须与 url 对应，不是文章 ID。
微信把查看留言、发表回复、删除回复和精选管理列为不同操作。这里的 comment_replies 只读取已有回复，不因为名称含 replies 就具备发表、删除或管理留言的能力。官方来源：微信：已有回复与留言管理操作来源核查：2026-09-04
content_id可选: comment_id 的兼容字段，低于 comment_id。

微信公众号特有返回字段与含义（2）

province: 所在省份。
author_avatar_url: 作者头像。

怎么调用微信公众号文章传播数据 API？

article_metrics

使用 platform="wechat_oa"、action="article_metrics" 调用“文章传播数据”能力；返回单个对象，主要包含 read_count、like_count、watching_count、share_count、collect_count、comment_count 等 7 个字段。

微信公众号 article_metrics 的参数分别是什么意思？

url必填: article_comments / comment_replies / article_metrics 使用 mp.weixin.qq.com 的具体文章链接；账号类接口仅把它作为公众号解析的最低优先级输入。
微信官方分析接口提供本授权公众号图文的阅读、分享等日期统计；它依赖本账号授权和规定日期范围，不是输入任意 mp.weixin.qq.com 文章 URL 即可查询，EveryInfra 的 url 访问模型及各返回字段必须独立验证。官方来源：微信公众号：本账号图文分析数据来源核查：2026-09-05

微信公众号特有返回字段与含义（2）

watching_count: 在看数。公众号特有的互动指标，区别于点赞。
read_count: 阅读数。

怎么调用微信公众号微信指数 API？

wechat_index

使用 platform="wechat_oa"、action="wechat_index" 调用“微信指数”能力；返回单个对象，主要包含 keyword、latest_index、latest_date、data_points、trend、platform。

腾讯 2017 年第一季度官方业绩材料确认微信指数用于分析关键词在微信公众号中的热度；该历史材料只支撑 keyword 与指数对象的概念关系，不证明当前开放 API、数据点周期、更新频率、字段结构或 EveryInfra 生产能力。官方来源：腾讯：微信指数用于分析关键词热度来源核查：2026-09-05

微信公众号 wechat_index 的参数分别是什么意思？

keyword必填: article_search 搜文章，account_search 搜公众号，mini_program_search 搜小程序，search_suggestions 取联想词，wechat_index 取关键词指数；这些都不是个人微信聊天搜索。

微信公众号特有返回字段与含义（5）

keyword: 查询的关键词。
latest_index: 最新一期的指数值。
latest_date: 最新一期的日期。
trend: 指数随时间的变化序列。
data_points: 趋势数据点数量。

一次微信公众号 article_search 调用的全过程：向 POST /api/v1/social 发送 platform="wechat_oa"、action="article_search"，以及必填参数 keyword;返回结构化 JSON，含 id、title、summary、url、cover_image_url 等字段；返回列表，单次最多 400 条，计费 $5.56 / 千次，失败与空结果不计费。

微信公众号原始字段名

EveryInfra 统一字段名

左边是微信公众号数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

微信公众号的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 28 个字段名只在微信公众号出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

account_name
relative_time
account_id
ghid
alias
verify_flag
biz
is_minigame
suggestions
account_type
customer_type
verify_status
verify_type
verified_at
registered_country
registered_at
is_overseas
last_login_province

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
summary: 摘要。
url: 该记录在原平台上的可访问链接。
cover_image_url: 封面图。
account_name: 公众号名称。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
relative_time: 相对时间描述（如「3天前」）。
kind: 条目类别。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
account_id: 公众号 ID。
ghid: 同 account_ghid。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
description: 简介或描述，通常比 text 短。
alias: 公众号自定义的微信号。
avatar_url: 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
verify_flag: 认证标记。
biz: 公众号的 __biz 参数，文章链接里带的标识。
icon_url: 公众号头像。
username: 用户名（@handle）。
is_minigame: 是否为小游戏关联账号。
suggestions: 相关推荐词。
count: 数量。
account_type: 账号类型（订阅号 / 服务号）。
company_name: 认证主体的公司名称。
owner_name: 运营者名称。
customer_type: 主体类型（个人 / 企业 / 政府 / 媒体）。
verify_status: 认证状态。
verify_type: 认证类型。
verified_at: 认证时间。
registered_country: 注册国家。
registered_at: 注册时间。
is_overseas: 是否为境外主体。
last_login_province: 最近登录省份。
authorized_agents: 授权代理机构。
position: 排名位置。
is_original: 是否为原创声明文章。
is_deleted: 内容是否已被删除。
account_ghid: 公众号的 gh_ 开头原始 ID，微信体系内的唯一标识。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
author_name: 作者昵称（显示名）。
author_avatar_url: 作者头像。
like_count: 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
is_top: 是否为置顶内容。
reply_count: 回复数，通常用于评论的子回复。null 表示不公开。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
province: 所在省份。
city: 城市名，用原平台的语言书写，未做中英归一。
read_count: 阅读数。
watching_count: 在看数。公众号特有的互动指标，区别于点赞。
share_count: 分享/转发数。null 表示不公开，不等于 0。
collect_count: 收藏数。null 表示不公开，不等于 0。
comment_count: 评论数。null 表示不公开，不等于 0。
keyword: 查询的关键词。
latest_index: 最新一期的指数值。
latest_date: 最新一期的日期。
data_points: 趋势数据点数量。
trend: 指数随时间的变化序列。

请求填写示例

这里检索公众号文章；公众号 ID、文章 URL 和父评论 ID 分属其他接口。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

wechat_oa_article_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"wechat_oa","action":"article_search","params":{"keyword":"城市更新"}}'

记录字段预览（非真实响应）

仅展示 article_search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "title": null,
  "summary": null,
  "url": null,
  "cover_image_url": null,
  "account_name": null,
  "posted_at": null,
  "relative_time": null,
  "kind": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

搜索公众号文章标题与摘要

用 article_search 找文章线索，再按文章链接核对内容。

查看 article_search 的 category 参数 →

keyword 搜文章；category=ALL / LATEST / HOT 对应全部、最新、热门栏目，FOLLOWED / RECENT_READ 涉及用户状态，当前不会读取你的关注或阅读记录，不保证可用。
title、summary、url、account_name 与 posted_at 是搜索结果信息，不是文章完整正文；relative_time 是相对时间文字，不应替代明确的发布时间。

搜索公众号并分清微信号与原始 ID

用 account_search 找账号，取得后续资料和文章查询的标识。

查看 account_search 的 keyword 参数 →

keyword 搜公众号，不搜个人微信联系人；account_id 是公众号微信号，ghid 是原始 ID，name 是显示名称，biz 是另一种账号关联标识。
后续 account 参数可用账号微信号或 gh_ 开头的原始 ID，不把名称、biz 或小程序 appid 当成同一种输入；verify_flag 未有完整值域说明，不要把任意非零值当成已认证。

按关键词发现微信小程序

用 mini_program_search 查询小程序条目，与公众号搜索分开。

查看 mini_program_search 的 keyword 参数 →

keyword 搜小程序，id 对应 appid，name / description 描述小程序，username 可能是 gh_…@app 形式的标识；不要拿它直接当公众号微信号。
is_minigame 按实际返回读取，不从名称推断小游戏类型；这里只提供搜索元数据，不执行小程序、不读取其用户数据或聊天记录。

用微信搜索联想词扩展检索问题

用 search_suggestions 取得候选词，再决定是否分别检索文章或账号。

查看 search_suggestions 的 keyword 参数 →

keyword 是联想起点，suggestions 是字符串数组；count 按返回的联想数量记录，不是关键词搜索量。
联想结果不是文章列表，也不是微信指数；不根据候选词顺序推断流量规模、用户画像或转化率。

读取公众号名称、类型与简介

用 account_profile 核对账号基本信息，不混入主体审核结论。

查看 account_profile 的 account 参数 →

account 填公众号微信号、gh_ 原始 ID 或可解析账号的链接，不是个人微信号；account_id、name、account_type、description 与 biz 用于核对。
account_type 用于描述账号类型，而不是认证状态；此结果不包含订阅者名单或后台的阅读报告，账号信息应另行使用 account_principal。

核对公众号主体名称与认证记录

用 account_principal 区分账号品牌名与登记主体信息。

查看 account_principal 的 account 参数 →

account 与账号资料接口使用相同的公众号标识；name、company_name / owner_name、verify_status、verify_type 与 verified_at 描述不同信息，认证时间不等于账号注册时间。
registered_country / registered_at 按实际返回读取；缺失主体信息不证明个人或企业不存在，认证字段也不是工商实时核验或 EveryInfra 的信用背书。

整理指定公众号的历史文章链接

用 account_articles 建立文章索引，不把列表当作全文归档。

查看 account_articles 的 account 参数 →

account 指定公众号；id、title、url、posted_at、account_id 与 account_ghid 保留文章及账号关系，is_original / is_deleted 按实际返回标记读取。
当前没有开始/结束日期筛选，不保证全部历史。当前默认返回 8 条、公开上限 160 条，最终响应按条数硬截断。position 的基数尚未确认，不直接把它解释成头条或自行加一。

检查公众号当日返回的文章

用 account_today_articles 与历史列表分开记录当天观察结果。

查看 account_today_articles 的 account 参数 →

account 指定公众号，读取 title、url、posted_at 与 account_id；这是当日文章入口，不是定时订阅、推送任务或历史日期查询。
当日的时区和刷新边界尚未独立验证，按实际 posted_at 核对；空列表不直接证明该公众号今天没有发布，重复采集应按链接或文章标识去重。

读取某篇公众号文章的可见留言

用 article_comments 取得评论记录，再按需要查询其中一条的回复。

查看 article_comments 的 url 参数 →

url 填 mp.weixin.qq.com 的具体文章链接；id 是评论 ID，text 是评论内容，reply_count 是回复数量，is_top 是置顶标记，不等同于精选认证。
有回复数量不代表已经取回回复；查询 comment_replies 时须把此评论 id 与同一文章 url 配对。这里只读取数据，不提供精选、删除或关闭留言操作，也不承诺后台全部留言可见。

读取公众号指定留言下的回复

用 comment_replies 将文章和评论一起定位，不拿文章 ID 代替评论 ID。

查看 comment_replies 的 comment_id 参数 →

同时提供 url 与 comment_id，后者来自同一文章的 article_comments；返回 id 是回复记录的标识，text / author_name / posted_at 描述回复。
这个接口读取已有回复，不是替公众号发表回复；country / province / city 是结果中的地区描述，不是精确地址，也不能据此确认用户身份。

区分公众号文章阅读、点赞与在看

用 article_metrics 保存单篇文章的互动快照，避免混算不同指标。

查看 article_metrics 的 url 参数 →

url 指向具体文章；read_count 是阅读计数，like_count 是点赞，watching_count 对应在看，share_count / collect_count / comment_count 分别描述分享、收藏、评论。
在看不是正在在线阅读的人数，阅读计数也不等于独立读者；缺失值不补零，不据这些字段推断读者名单、实时在线数或公众号后台完整报表。

把微信指数当作关键词热度序列读取

用 wechat_index 查看返回的日期与指数，再决定如何做趋势比较。

查看 wechat_index 的 keyword 参数 →

keyword 是指数查询词；latest_index / latest_date 描述最近值，trend 是包含 date、index 的条目数组，data_points 是返回的数据点数量信息。
指数不是搜索人数、文章阅读量或联想词数量；没有开放起止日期参数，不承诺固定历史跨度，也不在缺少计算方式说明时将跨关键词指数换算为市场份额。

微信公众号 API 常见问题

微信公众号 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="wechat_oa"、action 和 params。以 article_search 为例，必填 keyword，可选 category、sub_type。这里检索公众号文章；公众号 ID、文章 URL 和父评论 ID 分属其他接口。微信公众号共 12 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

微信公众号 API 怎么收费？

$5.56 / 千次，微信公众号全部 12 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 179 次微信公众号调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

微信公众号 API 一次能返回多少条数据？

微信公众号有 7 个列表接口，包括 article_search、account_search、mini_program_search、account_articles、account_today_articles、article_comments、comment_replies。其余 5 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

微信公众号 API 返回哪些字段？

当前目录为 article_search 列出 id、title、summary、url、cover_image_url、account_name 等 10 个字段名。按全站当前目录统计，28 个字段名只在微信公众号出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「搜索公众号文章标题与摘要」怎样接入微信公众号 API？

用 article_search 找文章线索，再按文章链接核对内容。 keyword 搜文章；category=ALL / LATEST / HOT 对应全部、最新、热门栏目，FOLLOWED / RECENT_READ 涉及用户状态，当前不会读取你的关注或阅读记录，不保证可用。 title、summary、url、account_name 与 posted_at 是搜索结果信息，不是文章完整正文；relative_time 是相对时间文字，不应替代明确的发布时间。

「搜索公众号并分清微信号与原始 ID」怎样接入微信公众号 API？

用 account_search 找账号，取得后续资料和文章查询的标识。 keyword 搜公众号，不搜个人微信联系人；account_id 是公众号微信号，ghid 是原始 ID，name 是显示名称，biz 是另一种账号关联标识。后续 account 参数可用账号微信号或 gh_ 开头的原始 ID，不把名称、biz 或小程序 appid 当成同一种输入；verify_flag 未有完整值域说明，不要把任意非零值当成已认证。

「按关键词发现微信小程序」怎样接入微信公众号 API？

用 mini_program_search 查询小程序条目，与公众号搜索分开。 keyword 搜小程序，id 对应 appid，name / description 描述小程序，username 可能是 gh_…@app 形式的标识；不要拿它直接当公众号微信号。 is_minigame 按实际返回读取，不从名称推断小游戏类型；这里只提供搜索元数据，不执行小程序、不读取其用户数据或聊天记录。

「用微信搜索联想词扩展检索问题」怎样接入微信公众号 API？

用 search_suggestions 取得候选词，再决定是否分别检索文章或账号。 keyword 是联想起点，suggestions 是字符串数组；count 按返回的联想数量记录，不是关键词搜索量。联想结果不是文章列表，也不是微信指数；不根据候选词顺序推断流量规模、用户画像或转化率。

可以先免费试用微信公众号 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择微信公众号的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 12 个能力。无需信用卡。

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 豆瓣 API 抖音 API 全部 89 平台 ↗

开始调用微信公众号 API

加微信领 $1 免费额度，先选一个微信公众号接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始

微信公众号 API

微信公众号 能力清单

微信公众号 每个接口分别做什么

怎么调用 微信公众号 文章搜索 API？

微信公众号 article_search 的参数分别是什么意思？

怎么调用 微信公众号 公众号搜索 API？

微信公众号 account_search 的参数分别是什么意思？

怎么调用 微信公众号 小程序搜索 API？

微信公众号 mini_program_search 的参数分别是什么意思？

怎么调用 微信公众号 搜索联想 API？

微信公众号 search_suggestions 的参数分别是什么意思？

怎么调用 微信公众号 公众号资料 API？

微信公众号 account_profile 的参数分别是什么意思？

怎么调用 微信公众号 公众号主体信息 API？

微信公众号 account_principal 的参数分别是什么意思？

怎么调用 微信公众号 公众号历史文章 API？

微信公众号 account_articles 的参数分别是什么意思？

怎么调用 微信公众号 公众号当日文章 API？

微信公众号 account_today_articles 的参数分别是什么意思？

怎么调用 微信公众号 文章评论 API？

微信公众号 article_comments 的参数分别是什么意思？

怎么调用 微信公众号 评论回复 API？

微信公众号 comment_replies 的参数分别是什么意思？

怎么调用 微信公众号 文章传播数据 API？

微信公众号 article_metrics 的参数分别是什么意思？

怎么调用 微信公众号 微信指数 API？

微信公众号 wechat_index 的参数分别是什么意思？

微信公众号 的独有字段名（当前目录）

返回字段含义

请求填写示例

记录字段预览（非真实响应）

常见用例

搜索公众号文章标题与摘要

搜索公众号并分清微信号与原始 ID

按关键词发现微信小程序

用微信搜索联想词扩展检索问题

读取公众号名称、类型与简介

核对公众号主体名称与认证记录

整理指定公众号的历史文章链接

检查公众号当日返回的文章

读取某篇公众号文章的可见留言

读取公众号指定留言下的回复

区分公众号文章阅读、点赞与在看

把微信指数当作关键词热度序列读取

微信公众号 API 常见问题

微信公众号 API 怎么调用？

微信公众号 API 怎么收费？

微信公众号 API 一次能返回多少条数据？

微信公众号 API 返回哪些字段？

「搜索公众号文章标题与摘要」怎样接入 微信公众号 API？

「搜索公众号并分清微信号与原始 ID」怎样接入 微信公众号 API？

「按关键词发现微信小程序」怎样接入 微信公众号 API？

「用微信搜索联想词扩展检索问题」怎样接入 微信公众号 API？

可以先免费试用 微信公众号 API 吗？

更多社交内容 API

开始调用 微信公众号 API

微信公众号能力清单

微信公众号每个接口分别做什么

怎么调用微信公众号文章搜索 API？

怎么调用微信公众号公众号搜索 API？

怎么调用微信公众号小程序搜索 API？

怎么调用微信公众号搜索联想 API？

怎么调用微信公众号公众号资料 API？

怎么调用微信公众号公众号主体信息 API？

怎么调用微信公众号公众号历史文章 API？

怎么调用微信公众号公众号当日文章 API？

怎么调用微信公众号文章评论 API？

怎么调用微信公众号评论回复 API？

怎么调用微信公众号文章传播数据 API？

怎么调用微信公众号微信指数 API？

微信公众号的独有字段名（当前目录）

「搜索公众号文章标题与摘要」怎样接入微信公众号 API？

「搜索公众号并分清微信号与原始 ID」怎样接入微信公众号 API？

「按关键词发现微信小程序」怎样接入微信公众号 API？

「用微信搜索联想词扩展检索问题」怎样接入微信公众号 API？

可以先免费试用微信公众号 API 吗？

开始调用微信公众号 API