WeChat Official Account name search API
Find WeChat Official Accounts by name or keyword, closest first: original ID, WeChat ID, name, avatar, owner, and a third-party database's estimates of active followers, lead-article reads and likes, and articles a week (not official, possibly months old). Charged per account; limit sets how many (5 by default, at most 15). About 5 items a call, 15 at most; $0.05635 per item returned, at least $0.0600 and at most $0.84525 a call. Errors and timeouts are not charged; an empty result is free.
Try it
Change a value and the request on the right follows.Sign in to run it; it runs on your own balance.
{
"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 more
]
},
"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"
}
}
}From a response recorded 2026-10-29 09:47 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.
Size as sent: 1.0 KB in the standard view (715 B compact, 1.7 KB full).
{
"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" }
}
}From a recording of 2026-10-29 09:47 UTC, edited by hand to show this case. The request ID and balance are made up.
Size as sent: 514 B in the standard view (514 B compact, 514 B full).
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}"
}
}
}
}Add this to your MCP client, then ask your agent to call wechat_mp.accounts.search.
Parameters
The account's name, or a keyword. Example: 咖啡.
Items per page. Items per page, 1 to 15.
How much of each item to return. All three cost the same. Values: compact, standard (default), full.
Return only these fields. Each by its path, such as author.name.
Known limits
- About 5 items a page, 15 at most. Set it with
limit. - Everything comes in one page; no cursor is issued.
- 8 fields of the object are not available from this endpoint
Returned fields
data.items is a list of account objects. Stable: fields are only ever added.
ID
Handle
On this platform: The WeChat ID people type to find the account; null where none is set
Display name
Link to the profile
Bio
Long text: the compact view keeps the first 500 characters and says so in warnings.
Avatar
Show all 22 fields →
Whether the account is verified
When the account was created
Account counts
Followers
Following
Posts published
The account's __biz: what follows __biz= in the links of its articles
Name of the account's owner (a company or body); null for a personal account and where none is on record
Estimated active followers: a third-party database's estimate from reads and the like, not a follower count the platform publishes (it publishes none), and possibly weeks to months old
Estimated average reads of the account's lead articles: a third-party database's estimate, possibly out of date
Estimated average likes of the account's lead articles: a third-party database's estimate, possibly out of date
Estimated articles a week: as a third-party database counts them, possibly out of date
When the account last published, as a third-party database has it; earlier than the truth when the database has not caught up
Which numbers of this item are approximate or lower bounds; absent when all are exact
Path of the field, such as metrics.views
Approximate, or a lower boundapproximatelower_bound
Typical size of one item: compact 67 B, standard 174 B, full 423 B (measured on the response recorded 2026-10-29 09:47 UTC).
What this endpoint cannot give
urlThe platform has nonebioNot provided hereverifiedNot provided herecreated_atNot provided heremetricsThe platform has nonemetrics.followersThe platform has nonemetrics.followingThe platform has nonemetrics.postsThe platform has noneWhen you are charged
X-Max-Price to refuse anything above your own limit)Prices as read 2026-10-30 14:10 UTC, under price book 6, in effect since 2026-10-29 13:23 UTC; the Playground reads the price in force before a run.
Errors
What this endpoint can answer with; codes all endpoints share are on the full list.
invalid_paramsA parameter is invalidRetry: After a fixNoinsufficient_balanceThe balance is too lowRetry: After a fixNouncharged_cost_limitToo many of this account's calls today returned nothing and were not charged; endpoints of this kind can be called again tomorrow (UTC)Retry: YesNoupstream_failedThe data source failedRetry: YesNotimeoutThe data did not arrive in time; retry with the same idempotency keyRetry: YesNoQuestions
How much does the WeChat Official Account name search API cost?
$0.05635 per item returned, at least $0.0600 and at most $0.84525 a call. The most one call can cost is $0.84525.
When am I not charged?
Errors and timeouts are not charged; an empty result is free.
How many items does one call return, and how do I get the next page?
About 5 items a page, 15 at most. Set it with limit. Everything comes in one page; no cursor is issued.
30-day availability
13 days are on record. The share is written here once 14 days are.
It is not a success rate: how single calls went is not in it, and a failed call is not charged either way.
Every endpoint's state now, and each incident with whether anyone was charged: the status page →
The same thing on other platforms
All 8 WeChat Official Accounts endpoints
Use it in your AI
Copy this prompt
Your API key is built in, so there is nothing to configure.
No account yet? Sign-up takes an email and no card, and a failed call is never charged.
Paste it into your agent
It reads the page the prompt points to and connects itself.
Now ask something
Use one of these, or your own words.
Prefer to set it up by hand?
dataxapi setupgives the agents on your machine (Claude Code, Codex, Cursor) the DataXAPI MCP server and the base skill. The key is read from DATAXAPI_API_KEY; none is written into a file.MCP server: https://api.dataxapi.com/mcp. The entry for your client is under MCP in the request examples of this page; then ask your agent to call wechat_mp.accounts.search.Other clients →Show the text
Use the DataXAPI endpoint wechat_mp.accounts.search (WeChat Official Account name search). Find WeChat Official Accounts by name or keyword, closest first: original ID, WeChat ID, name, avatar, owner, and a third-party database's estimates of active followers, lead-article reads and likes, and articles a week (not official, possibly months old). Charged per account; limit sets how many (5 by default, at most 15). Call GET https://api.dataxapi.com/v1/wechat_mp/accounts/search with the header "Authorization: Bearer $DATAXAPI_API_KEY". Read the key from the environment variable DATAXAPI_API_KEY; never write it into code. Parameters: - query (required): The account's name, or a keyword. Example: 咖啡. - limit: Items per page. Items per page, 1 to 15. - view: How much of each item to return. All three cost the same. Values: compact, standard (default), full. - fields: Return only these fields. Each by its path, such as author.name. Price: $0.05635 per item returned, at least $0.0600 and at most $0.84525 a call. Errors and timeouts are not charged; an empty result is free. The answer is JSON: data.items holds account; meta.billing.amount is what this call was charged. Example: curl -G "https://api.dataxapi.com/v1/wechat_mp/accounts/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" Full reference in Markdown: https://dataxapi.com/apis/wechat_mp/accounts/search.md
Names and identifiers
- In Chinese
- 微信公众号账号搜索 API
- Endpoint ID
wechat_mp.accounts.search- Endpoint
GET /v1/wechat_mp/accounts/search
Start with one key.
224 endpoints on 21 platforms, from $0.0003 a call. Errors and timeouts are not charged.