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: 7 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.
7 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 - WeChat official account search V2
GET /v1/raw/wechat/account_search_v2Search WeChat official accounts by name or keyword, returned as the platform answers in JSON: data holds result groups, and each group's subBoxes[].items lists the accounts with name (nickName), WeChat ID (aliasName), original ID (userName, gh_…), description, avatar, verifying organization and tags, plus the match total totalCount and the search term query. First page only (about 20 accounts), not paginated. Fast: usually about 2 seconds. No matching account answers empty. Only an answer with data is charged; an empty answer or an error is not.Required: keyword - WeChat Channels search V2
GET /v1/raw/wechat/channel_search_v2Search WeChat Channels (视频号) accounts by name or keyword, returned as the platform answers in JSON: v2_info_list holds the matching accounts (contact has the account identifier username, name, bio, avatar, verification, region and live status, plus the highlighted name and bio), video_object_list the related videos (description, cover, play URL and engagement counts), and continue_flag says whether more exist. First page only, not paginated. Slower: usually about 4 seconds. No matching account leaves v2_info_list empty and answers empty. Only an answer with data is charged; an empty answer or an error is not.Required: keyword - WeChat article full text V3
GET /v1/raw/wechat/article_content_v3The full text of one WeChat official account article, in the platform's own JSON: title, account name (nick_name) and ID (alias), author, digest (desc), publish time, cover (cdn_url), the body as plain text and as HTML, pictures and links in the body, copyright and IP location and more. Pass the mp.weixin.qq.com article link as url. Responses usually take about 3 seconds. The body text and HTML are in content and content_multi_text. A long article makes a large response, so allow for a big payload. An article that does not exist or was deleted answers 404 and is not charged. Only an answer with a title or body text is charged; an empty answer or an error is not.Required: url
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 7 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.