微信公众号账号搜索 API
按名字或关键词找公众号,最像的排前面:原始编号、微信号、名称、头像、主体名称,和第三方数据库的预估活跃粉丝、头条平均阅读和点赞、每周发文数(估计值,非官方,可能滞后数月)。按条计费,limit 定条数(默认 5,最多 15)。每次约 5 条,最多 15 条;每返回一条 $0.05635,每次最少 $0.0600、最多 $0.84525。出错和超时不收费;空结果不收费。
{
"code": "ok",
"request_id": "6a0decec-3648-4ce7-ae73-2a1d2bd7fad5",
"data": {
"items": [
{
"id": "gh_5f2e34769fdc",
"username": "aya_living",
"name": "认真生活的阿雅",
"avatar_url": "https://wx.qlogo.cn/mmhead/LO7unl2CpHGnNeCMRIFsNNLZ2CsNrwgfzOG5J5d3/132"
},
// … 另有 2 条
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 3
},
"warnings": [],
"meta": {
"capability": "wechat_mp.accounts.search",
"result_status": "complete",
"fetched_at": "2026-10-29T09:47:33.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"url": "platform",
"bio": "capability",
"verified": "capability",
"created_at": "capability",
"metrics": "platform"
},
"billing": {
"amount": "0.16905",
"currency": "USD",
"balance_after": "9.83095"
}
}
}取自 2026-10-29 09:47 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。
返回大小:标准档 1.0 KB(精简 715 B,完整 1.7 KB)。
{
"code": "ok",
"request_id": "f5225d6d-edcf-4b7b-813a-c9be62ac4f31",
"data": { "items": [] },
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 0
},
"warnings": [],
"meta": {
"capability": "wechat_mp.accounts.search",
"result_status": "empty",
"fetched_at": "2026-10-29T09:47:33.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"url": "platform",
"bio": "capability",
"verified": "capability",
"created_at": "capability",
"metrics": "platform"
},
"billing": { "amount": "0", "currency": "USD", "balance_after": "10" }
}
}取自 2026-10-29 09:47 UTC 的录制,为演示这种情况人工改过。请求号和余额是示意。
返回大小:标准档 514 B(精简 514 B,完整 514 B)。
curl -G "https://api.dataxapi.com/v1/wechat_mp/accounts/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
# pip install dataxapi from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.wechat_mp.accounts.search(query="咖啡") print(result["data"]["items"])
// npm i @dataxapi/sdk import { DataXAPI } from "@dataxapi/sdk"; const dx = new DataXAPI(); // reads DATAXAPI_API_KEY const result = await dx.wechat_mp.accounts.search({ query: "咖啡" }); console.log(result.data.items);
dataxapi call wechat_mp.accounts.search 'query=咖啡'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端,然后让你的 AI 调用 wechat_mp.accounts.search。
参数
公众号名称或关键词。示例:咖啡。
每页条数。每页条数,1 到 15。
返回档位。三档价格相同。取值:compact、standard(默认)、full。
只要这些字段。按路径写,例如 author.name。
已知限制
- 每页约 5 条,最多 15 条。可以用
limit调。 - 一次给全,不发游标。
- 这个对象有 8 个字段这个接口给不了
返回字段
data.items 是账号对象的列表。稳定:字段只增不改。
编号
账号名
在这个平台上:微信号:在微信里搜索添加时输入的那个;没设的为 null
显示名
主页链接
简介
长文本:精简档只保留前 500 个字符,并在 warnings 里写明。
头像
展开全部 22 个字段 →
是否认证
账号创建时间
账号的数字
粉丝数
关注数
发布的内容数
公众号的 __biz:它的文章链接里 __biz= 后面那一段
账号主体的名称(公司、机构);个人账号和没登记的为 null
预估活跃粉丝数:第三方数据库按文章阅读等推算的估计值,不是平台公布的粉丝数(平台不公开粉丝数),可能滞后数周到数月
预估头条文章平均阅读数:第三方数据库的估计值,可能滞后
预估头条文章平均点赞数:第三方数据库的估计值,可能滞后
预估每周发文数:第三方数据库记的数,可能滞后
第三方数据库记的最近一次发文时间;数据库没跟上时会比真实的早
这一条里哪些数是约数或下限;都是准确值时不出现
字段的路径,如 metrics.views
约数,还是下限approximatelower_bound
每条数据的典型体积:compact 67 B、standard 174 B、full 423 B(按 2026-10-29 09:47 UTC 录下的那次返回量的)。
这个接口给不了的
url平台没有bio这个接口不提供verified这个接口不提供created_at这个接口不提供metrics平台没有metrics.followers平台没有metrics.following平台没有metrics.posts平台没有什么时候收费
X-Max-Price 可以设自己的上限,超过就不执行)价格读取于 2026-10-30 14:10 UTC,按价目版本 6,2026-10-29 13:23 UTC 起生效;在 Playground 里运行前会再读一次当前价格。
常见报错
这个接口会返回的错误码;所有接口共有的见完整列表。
invalid_params参数不合法能否重试:改了再试未扣费insufficient_balance余额不足能否重试:改了再试未扣费uncharged_cost_limit这个账户今天没取到数据、也没扣费的调用太多,这类接口到明天(UTC)再调能否重试:能未扣费upstream_failed数据来源出错能否重试:能未扣费timeout没有在时限内取到数据,可以用同一个幂等键重试能否重试:能未扣费常见问题
微信公众号账号搜索 API 多少钱?
每返回一条 $0.05635,每次最少 $0.0600、最多 $0.84525。单次最高扣费 $0.84525。
什么情况下不收费?
出错和超时不收费;空结果不收费。
一次返回多少条?怎么翻页?
每页约 5 条,最多 15 条。可以用 limit 调。一次给全,不发游标。
近 30 天可用率
已记录 13 天,满 14 天后在这里写出比例。
这不是成功率:单次调用成没成功不在里面;调用失败本来就不收费。
同一件事的其他平台
微信公众号的全部 8 个接口
在你的 AI 里用它
复制这段提示词
你的 API Key 已经写在里面,不用再配置什么。
还没有账户?注册只要一个邮箱,不用绑卡,失败的调用不收费。
贴给你的 agent
它会去读提示词指向的那一页,自己接好。
现在问点什么
用下面任意一句,或者用自己的话问。
想自己手动配置?
dataxapi setup给这台电脑上的 AI 代理(Claude Code、Codex、Cursor)装好 DataXAPI 的 MCP 服务和基础技能。Key 从环境变量 DATAXAPI_API_KEY 读,不写进任何文件。MCP 服务地址:https://api.dataxapi.com/mcp。你的客户端要填的配置在本页请求示例的“MCP”页签里;接好后让你的 AI 调用 wechat_mp.accounts.search。其他客户端 →展开全文
使用 DataXAPI 的接口 wechat_mp.accounts.search(微信公众号账号搜索)。按名字或关键词找公众号,最像的排前面:原始编号、微信号、名称、头像、主体名称,和第三方数据库的预估活跃粉丝、头条平均阅读和点赞、每周发文数(估计值,非官方,可能滞后数月)。按条计费,limit 定条数(默认 5,最多 15)。 用 GET 请求 https://api.dataxapi.com/v1/wechat_mp/accounts/search,带请求头 "Authorization: Bearer $DATAXAPI_API_KEY"。Key 从环境变量 DATAXAPI_API_KEY 读,不要写进代码。 参数: - query (必填):公众号名称或关键词。示例:咖啡。 - limit:每页条数。每页条数,1 到 15。 - view:返回档位。三档价格相同。取值:compact、standard(默认)、full。 - fields:只要这些字段。按路径写,例如 author.name。 价格:每返回一条 $0.05635,每次最少 $0.0600、最多 $0.84525。出错和超时不收费;空结果不收费。 返回 JSON:data.items 是账号;meta.billing.amount 是这次调用的扣费。 示例: curl -G "https://api.dataxapi.com/v1/wechat_mp/accounts/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" 完整说明(Markdown):https://dataxapi.com/zh/apis/wechat_mp/accounts/search.md
名称和编号
- 英文名
- WeChat Official Account name search API
- 接口编号
wechat_mp.accounts.search- 地址
GET /v1/wechat_mp/accounts/search
一把 Key,开始用。
21 个平台 224 个接口,一次 $0.0003 起。出错和超时不收费。