WeChat Official Accounts search API
Search Official Accounts by keyword. Each row is one account candidate with name, description, alias, ghid, verify_flag and biz, for $16 per 1,000 calls.
ghidgoes straight intoaccounton the profile, owner and article capabilities.- It searches accounts, not articles.
- Failed calls and empty results are not charged.
May be temporarily unavailable at peak times
This capability may be temporarily unavailable at peak times; try again later. Failed calls are not charged.
API health
- 24h health
- Limited
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "wechat_oa", "action": "account_search", "params": { "keyword": "科技" } }2JSON response
{ "results": [ { "name": "科•••兽", "ghid": "gh_021a2971bb29", "alias": "KeJiShouX", "verify_flag": 1 }, … ], "count": 14 }3Rows
name ghid alias verify_flag 科•••兽 gh_021a2971bb29 KeJiShouX 1 惠•••技 gh_1306e540f321 1 4CSV
wechat_oa-account_search-sample.csv account_id,ghid,name,description,alias,avatar_url,verify_flag,biz,platform
keyword goes in, and a batch of account candidates comes back; each row in results is one account, listed as a field table and a CSV file.What data you get
The table shows a real call for 科技, captured October 24, 2026 at 18:28 (UTC), that returned 14 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| account_id | ghid | name | description | alias | avatar_url | verify_flag | biz | platform |
|---|---|---|---|---|---|---|---|---|
null | gh_021a2971bb29 | 科•••兽 | KeJiShouX | 1 | wechat_oa | |||
null | gh_1306e540f321 | 惠•••技 | 1 | wechat_oa |
Use cases
Build a list of accounts for an industry
Set
keywordto an industry term and readnameanddescriptionin each row to pick out a first set of similar accounts.Find an account identifier from a name
Search the name, confirm which candidate is the right one, then pass its
ghidasaccounttoaccount_profile.Tell accounts with the same name apart
Compare
alias,verify_flaganddescription, then de-duplicate withghidorbiz.Match article links to an account
The
__bizvalue in an article link is thebizvalue here, so you can use it to tell which account a set of articles belongs to.
Limits and gotchas
keywordis required and searches Official Accounts. It does not search articles or mini programs, and it does not search personal WeChat contacts.limitis capped at 400 rows per call; this capability has no paging parameter.aliasis the custom WeChat ID of the account and may be empty.verify_flagis the verification mark. Its values have no full description, so check the values you actually get before you sort accounts by verification.- To read a single account next,
accounttakesghid(the original ID that starts with gh_) or the account's WeChat ID.
Pricing
You pay $0.016 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $160.00 |
| 100,000 | $1,600.00 |
| 1,000,000 | $16,000.00 |
Totals use the list price per call.
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "wechat_oa",
"action": "account_search",
"params": {
"keyword": "科技"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
API reference
See the parameters, response fields, errors and billing for account_search, and copy the page or open it as Markdown for an AI assistant.
AI prompt
#Please help me write a data collection script with the EveryInfra WeChat Official Accounts Account search endpoint (wechat_oa/account_search).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to wechat_oa and action to account_search, and put the parameters inside params.
- Required parameters:
- keyword: Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions…
- Optional parameters:
- limit: The most rows to return in this call, an integer from 1 to 400. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: account_id (Official Account ID (its WeChat ID)), ghid, name, description, alias, avatar_url, verify_flag, biz.
- Example request body:
{
"platform": "wechat_oa",
"action": "account_search",
"params": {
"keyword": "科技"
}
}
- Price: $16 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | wechat_oa | Platform identifier, fixed value. |
action | body | string | Yes | account_search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats. |
limit | body.params | integer (1–400) | No | 20 | The most rows to return in this call, an integer from 1 to 400. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Response example
#{ "id": "req_…", "platform": "wechat_oa", "action": "account_search", "results": [ { "ghid": "gh_021a2971bb29", "name": "科•••兽", "description": "•••", "alias": "KeJiShouX", "avatar_url": "http://mmbiz.qpic.cn/•••", "verify_flag": 1, "biz": "•••", "platform": "wechat_oa" }, { "ghid": "gh_1306e540f321", "name": "惠•••技", "description": "•••", "alias": "", "avatar_url": "http://mmecoa.qpic.cn/•••", "verify_flag": 1, "biz": "•••", "platform": "wechat_oa" } ], "count": 14, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
account_id | Official Account ID (its WeChat ID). |
ghid | Keeps the platform's own meaning |
name | Name of the object itself, for account, product and business capabilities. |
description | Summary or description, usually shorter than text. |
alias | Keeps the platform's own meaning |
avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
verify_flag | Keeps the platform's own meaning |
biz | Keeps the platform's own meaning |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- WeChat: Official Account Nickname, WeChat ID, and Original ID ↗
WeChat documentation defines nick_name, alias, and user_name as the nickname, user-configured WeChat ID, and original ID respectively, where alias may be empty. In search results on this page, name, account_id, and ghid must be verified individually and not treated as identical strings.
Checked 2026-09-04
FAQ
What does account search return?
Each row is one Official Account: ghid, name, description, alias, avatar_url, verify_flag and biz. The field table also lists account_id.
What do I pass to account after a search?
Use ghid from the row you picked, or the account's WeChat ID. Both work on account_profile, account_principal, account_articles and account_today_articles. A personal WeChat ID does not work.
Does keyword search accounts or articles?
Accounts. Each row is one account and not an article. To search articles, use article_search.
How much does one search cost?
It costs $0.016 per call, or $16 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.
Related WeChat Official Accounts endpoints
You can call the other WeChat Official Accounts endpoints with the same EveryInfra API key.
- Article search
article_search$8 per 1,000 callsSearch WeChat Official Account articles by keyword through an English-documented API, up to 400 articles per call. - Article details
article_detail$5.56 per 1,000 callsFetch the full body of one WeChat Official Account article as plain text and original HTML. - Mini Program search
mini_program_search$5.56 per 1,000 callsDiscover WeChat Mini Programs for a keyword, with name, icon, description, username and whether each one is a mini game. - Search suggestions
search_suggestions$5.56 per 1,000 callsGet the autocomplete suggestions WeChat offers for a keyword, along with the number of terms returned. - Account details
account_profile$8 per 1,000 callsGet a WeChat Official Account profile as JSON. - Account owner
account_principal$5.56 per 1,000 callsRead the registered owner behind a WeChat Official Account. - Account articles
account_articles$8 per 1,000 callsPull the article history of one WeChat Official Account, 8 by default and up to 160 per call. - Today's account articles
account_today_articles$8 per 1,000 callsTrack what one WeChat Official Account has published today, with each article's title, link, cover, publish time, position and original or deleted flags. - Article comments
article_comments$6.76 per 1,000 callsCollect reader comments on one WeChat Official Account article, up to 260 per call. - Comment replies
comment_replies$6.76 per 1,000 callsList the replies under one comment on a WeChat Official Account article. - Article engagement
article_metrics$5.56 per 1,000 callsCheck engagement on one WeChat Official Account article. - WeChat Index
wechat_index$5.56 per 1,000 callsGauge how much attention a keyword gets on WeChat: the latest index value and its date, plus the trend series behind it.