EN开始使用充值
开始使用充值登录 / 注册控制台
中EN

公众号文章搜索 API：按公众号查历史文章和阅读数据

要查某个公众号发过什么，要分三步：先按名称或关键词找到公众号，拿到它的 mp_id；再用 mp_id 列出它的历史文章；最后拿一篇文章的链接读阅读等数据。下面每一步都是真实的接口和参数。

领取 50 次试用调用API 参考

新账号有 50 次试用调用，之后按成功调用从预充值余额扣费，详见 定价。

三步查一个公众号的文章

示例里的「央视新闻」换成你要找的公众号。第二步示例中的 mp_id 是占位符，要换成第一步返回的 mp_id。需要 API Key，新账号有 50 次试用调用。

  1. 按名称找到公众号

    用公众号名称或关键词搜索，每个结果带有 mp_id。kind 选账号类型：subscription 订阅号（默认）、service 服务号、all 两者合并去重。后面的步骤都要用这里返回的 mp_id。

    微信公众号搜索GET /v1/raw/wechat/account_search

    cURL
    curl 'https://api.qovia.ai/v1/raw/wechat/account_search?keyword=%E5%A4%AE%E8%A7%86%E6%96%B0%E9%97%BB' \
  -H "Authorization: Bearer $QOVIA_KEY"
    Python
    import os
import requests

resp = requests.get(
    "https://api.qovia.ai/v1/raw/wechat/account_search",
    params={"keyword": "央视新闻"},
    headers={"Authorization": f"Bearer {os.environ['QOVIA_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
body = resp.json()
print(body["meta"]["charged_usd"], body["data"])

    返回的 data 部分。示例取自接口目录，不是实时数据；列表只保留前两条，图片链接省略：

    200 OK
    {
  "data": {
    "items": [
      {
        "id": "soc_wec_f66c11bf1ab8",
        "mp_id": "gh_example",
        "name": "示例公众号",
        "wechat_id": "example_account",
        "description": "账号简介",
        "verified": true,
        "verified_by": "示例机构",
        "type": "subscription"
      }
    ],
    "cursor": null,
    "has_more": false,
    "prov": {
      "hash": "0xe249fde3d74fb05b",
      "ts": "2026-10-21T17:30:00+08:00",
      "source": "live"
    }
  }
}

  2. 列出这个公众号的历史文章

    mp_id 以 gh_ 或 wxid_ 开头，必须是上一步返回的值；示例里的 gh_example 只是占位符。第一页不传 cursor，翻页时把上一页返回的 cursor 传回来。

    微信公众号历史文章GET /v1/raw/wechat/articles

    cURL
    curl 'https://api.qovia.ai/v1/raw/wechat/articles?mp_id=gh_example' \
  -H "Authorization: Bearer $QOVIA_KEY"

  3. 读一篇文章的互动数据

    url 是文章链接，以 https://mp.weixin.qq.com/ 开头，可以取自上一步列出的文章。返回这篇文章的互动数据。示例里的链接是占位符。

    微信文章互动数据GET /v1/raw/wechat/article_metrics

    cURL
    curl 'https://api.qovia.ai/v1/raw/wechat/article_metrics?url=https%3A%2F%2Fmp.weixin.qq.com%2Fs%2Fexample' \
  -H "Authorization: Bearer $QOVIA_KEY"

更多相关接口

常见问题

mp_id 从哪里来？

来自公众号搜索（raw.wechat.account_search）返回的结果。它以 gh_ 或 wxid_ 开头，列出历史文章的接口只接受这种格式。

能搜公众号里的文章内容吗？

本页的做法是先找到公众号，再看它发过的文章。想按关键词跨公众号找文章，可以用跨平台检索（search），它的信源包括微信公众号。

视频号也能查吗？

可以。视频号搜索（raw.wechat.channel_search）按名称或关键词查找视频号账号，列在本页的更多接口里。

怎么计费？

新账号有 50 次试用调用，之后从预充值余额按次扣费，只对返回了数据的成功调用收费；空结果和报错不扣费，每次返回的 meta.charged_usd 写着这次扣了多少。各接口单价见 API 参考，套餐见定价页。

你的 Agent 能看到什么，取决于你给它什么数据

把抖音、小红书、公众号和电商评价交给它：结构化，按次计费，失败不扣费。

获取 API Key联系我们