WeChat Channels account search API
Find WeChat Channels accounts by name: the name has to match exactly, and every account of that name is returned, with its ID, name, signature, avatar, whether it is verified and what the verification says. The ID can be passed to the Channels profile, video list, live replay and other endpoints. About 1 item a call, 20 at most; $0.0600 per 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. New accounts can try this endpoint free, up to 1 calls.
curl -G "https://api.dataxapi.com/v1/wechat_channels/users/search" \ --data-urlencode "query=央视新闻" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
{
"code": "ok",
"request_id": "9b4ae98e-ff1c-4be2-a081-de7a4c417320",
"data": {
"items": [
{
"id": "v2_060000231003b20f05a99829d60f183968442cbbd75213164b2ee52fc0a0ade5678bd240c0@finder",
"name": "山野咖啡馆",
"bio": "记录生活里的小确幸|合作请私信",
"avatar_url": "https://wx.qlogo.cn/mmhead/sYXnQFwJZb0xiPhE5pI7TE9SVTvf0TcvVbc0dzgM/132",
"verified": false
},
// … 1 more
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 2
},
"warnings": [],
"meta": {
"capability": "wechat_channels.users.search",
"result_status": "complete",
"fetched_at": "2026-10-29T10:19:50.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"username": "platform",
"url": "platform",
"created_at": "capability",
"metrics": "capability"
},
"billing": {
"amount": "0.06",
"currency": "USD",
"balance_after": "9.94"
}
}
}From a response recorded 2026-10-29 10:19 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 (760 B compact, 1.0 KB full).
{
"code": "ok",
"request_id": "ed373f65-f881-4538-8c0d-835d00321267",
"data": { "items": [] },
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 0
},
"warnings": [],
"meta": {
"capability": "wechat_channels.users.search",
"result_status": "empty",
"fetched_at": "2026-10-29T09:50:40.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"username": "platform",
"url": "platform",
"created_at": "capability",
"metrics": "capability"
},
"billing": { "amount": "0", "currency": "USD", "balance_after": "10" }
}
}From a response recorded 2026-10-29 09:50 UTC. The request ID and balance are made up.
Size as sent: 498 B in the standard view (498 B compact, 498 B full).
curl -G "https://api.dataxapi.com/v1/wechat_channels/users/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_channels.users.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_channels.users.search({ query: "央视新闻" }); console.log(result.data.items);
dataxapi call wechat_channels.users.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_channels.users.search.
Parameters
The Channels account's name, exactly. Example: 央视新闻.
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 1 item a page, 20 at most. The page size is the platform's;
limitis not accepted. - Everything comes in one page; no cursor is issued.
- 7 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
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 16 fields →
Whether the account is verified
When the account was created
Account counts
Followers
Following
Posts published
What the verification says, in the platform's words: the owner's name for a company or body, a role or profession for a person; null when not verified
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 131 B, standard 253 B, full 281 B (measured on the response recorded 2026-10-29 10:19 UTC).
What this endpoint cannot give
usernameThe platform has noneurlThe platform has nonecreated_atNot provided heremetricsNot provided heremetrics.followersNot provided heremetrics.followingNot provided heremetrics.postsNot provided hereWhen 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 Channels account search API cost?
$0.0600 per call. The most one call can cost is $0.0600.
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 1 item a page, 20 at most. The page size is the platform's; limit is not accepted. 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 14 WeChat Channels 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_channels.users.search.Other clients →Show the text
Use the DataXAPI endpoint wechat_channels.users.search (WeChat Channels account search). Find WeChat Channels accounts by name: the name has to match exactly, and every account of that name is returned, with its ID, name, signature, avatar, whether it is verified and what the verification says. The ID can be passed to the Channels profile, video list, live replay and other endpoints. Call GET https://api.dataxapi.com/v1/wechat_channels/users/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 Channels account's name, exactly. Example: 央视新闻. - 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.0600 per 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_channels/users/search" \ --data-urlencode "query=央视新闻" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" Full reference in Markdown: https://dataxapi.com/apis/wechat_channels/users/search.md
Names and identifiers
- In Chinese
- 微信视频号账号搜索 API
- Endpoint ID
wechat_channels.users.search- Endpoint
GET /v1/wechat_channels/users/search
Start with one key.
224 endpoints on 21 platforms, from $0.0003 a call. Errors and timeouts are not charged.