WeChat Official Accounts & Channels API
Read official account search, an account's article history, article metrics and WeChat Channels search from WeChat Official Accounts & Channels over REST: 4 live endpoints, one API key and one JSON envelope. Below are all of them and a real request and response.
A new account gets 50 trial calls; after that, successful calls are billed from a prepaid balance. See pricing.
4 WeChat Official Accounts & Channels API endpoints
Parameters, response fields and code samples for each are in the API reference.
- WeChat official account search
GET /v1/raw/wechat/account_searchSearch WeChat official accounts by name or keyword: original ID (gh_…), name, WeChat ID, avatar, description, verifying organization and account type. One page of results, not paginated. kind picks subscription accounts, service accounts or both. No match answers empty and is not charged.Required: keyword - WeChat official account articles
GET /v1/raw/wechat/articlesHistory articles of one official account, newest first, one page per call: title, link, publish time, cover, digest, author, IP location and original/paid flags. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Take mp_id from raw.wechat.account_search. Empty pages are not charged.Required: mp_id - WeChat article metrics
GET /v1/raw/wechat/article_metricsReads, likes, "watching" (在看), comments and shares of one official account article, with the time the numbers were taken. url is the article's mp.weixin.qq.com link (full or /s/ short form, e.g. the url from raw.wechat.articles). Charged only when metrics come back.Required: url - WeChat Channels search
GET /v1/raw/wechat/channel_searchSearch WeChat Channels (视频号) accounts by name or keyword: account identifier (username), name, bio and avatar. One page of results, not paginated. No match answers empty and is not charged.Required: keyword
A request and its response
WeChat official account search（GET /v1/raw/wechat/account_search). The sample comes from the endpoint catalog, not live data; a full response also carries request_id and meta.
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"
{
"data": {
"items": [
{
"id": "soc_wec_f66c11bf1ab8",
"mp_id": "gh_example",
"name": "示例公众号",
"wechat_id": "example_account",
"avatar": "https://example.com/avatar.jpg",
"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"
}
}
}Use WeChat Official Accounts & Channels data from an AI tool
Qovia is also an MCP server. Run this in Claude Code. Finding and reading endpoints needs no key; to call them, set up your API key as in the MCP docs. Cursor and VS Code setups are there too.
claude mcp add --transport http qovia https://api.qovia.ai/mcpFAQ
How do I call the WeChat Official Accounts & Channels API?
Send a GET request to https://api.qovia.ai, for example /v1/raw/wechat/…, with your API key in an Authorization: Bearer header. A success is HTTP 200 with request_id, data and meta. This page lists all 4 endpoints, and each one's parameters are in the API reference.
Can I get another WeChat official account's articles? Can WeChat's own API do it?
WeChat's official account API only manages your own account; it cannot list another account's articles or their read counts. Qovia offers account search, article history and per-article metrics through one API key.
What data can I get?
Official account search (original ID, name, WeChat ID, bio, verified entity), an account's article history (title, link, publish time, cover, digest, author, original and paid flags, newest first, page by page), one article's reads, likes, 'watching', comments and shares, and WeChat Channels search.
How do I collect an account's articles and their read counts?
Find the account with official account search to get its mp_id, then page through the article history by passing back each page's cursor until has_more is false; for each article's reads and likes, call the article metrics endpoint with its link.
Do I need a WeChat account or cookies?
No. All you need is a Qovia API key: no accounts, cookies, proxies or request signing to maintain.
How is it billed?
Prepaid and per call: only successful calls that return data are charged, and empty results, errors and timeouts are not. Every response says what it cost (meta.charged_usd). Each endpoint's price is in the API reference.
Can I use it from Claude, Cursor or other AI tools?
Yes. Qovia is also an MCP server (https://api.qovia.ai/mcp): add it to Claude Code, Cursor or VS Code with your API key and the AI finds the endpoint, pulls the data and summarises it.
What should I keep in mind when using the data?
Qovia provides a data API service and claims no ownership of the underlying content. Use the data under applicable law and WeChat's platform rules; see our terms of service.
Your agent only knows what you give it
Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.