中Get startedTop up
Get startedTop upSign in / Sign upConsole
中EN

Search WeChat official account articles by account

To see what a specific WeChat official account has published, work in three steps: find the account by name or keyword and take its mp_id, list its past articles with that mp_id, then read the engagement numbers for one article from its link. Every step below is a real endpoint with real parameters.

Get 50 trial callsAPI reference

A new account gets 50 trial calls; after that, successful calls are billed from a prepaid balance. See pricing.

Look into one account's articles in three calls

Replace 央视新闻 in the examples with the account you are looking for. The mp_id in step 2 is a placeholder: use the mp_id returned by step 1. You need an API key, and a new account has 50 trial calls.

  1. Find the account by name

    Search by the account's name or a keyword; each result carries its mp_id. kind picks the account type: subscription (the default), service, or all, which merges both without duplicates. The later steps all need the mp_id returned here.

    WeChat official account searchGET /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"])

    The data in the response. The sample comes from the endpoint catalog, not live data; lists are cut to their first two entries and picture links are left out:

    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. List the account's past articles

    mp_id starts with gh_ or wxid_ and must be the value returned by the previous step; gh_example in the example is only a placeholder. Omit cursor for the first page, and pass back the cursor from the previous page to turn pages.

    WeChat official account articlesGET /v1/raw/wechat/articles

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

  3. Read one article's engagement

    url is the article link, starting with https://mp.weixin.qq.com/; take it from an article listed in the previous step. You get that article's engagement data. The link in the example is a placeholder.

    WeChat article metricsGET /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"

More endpoints for this

FAQ

Where does mp_id come from?

From the results of account search (raw.wechat.account_search). It starts with gh_ or wxid_, and the article-list endpoint accepts only that format.

Can I search the text of articles?

The approach on this page is to find the account first, then look at what it has published. To find articles by keyword across accounts, use the cross-platform search (search), whose sources include WeChat official accounts.

What about WeChat Channels (视频号)?

Yes. Channels search (raw.wechat.channel_search) finds Channels accounts by name or keyword; it is listed under more endpoints on this page.

How is it billed?

A new account gets 50 trial calls; after that, calls are billed from a prepaid balance, and only successful calls that return data are charged. Empty results and errors are not, and meta.charged_usd in each response says what the call cost. Each endpoint's price is in the API reference, and the plans are on the pricing page.

Your agent only knows what you give it

Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.

Get an API keyContact us