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.

  • ghid goes straight into account on 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
Limited

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "wechat_oa",
      "action": "account_search",
      "params": {
        "keyword": "科技"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "name": "科•••兽",
          "ghid": "gh_021a2971bb29",
          "alias": "KeJiShouX",
          "verify_flag": 1
        },
        …
      ],
      "count": 14
    }
  3. 3Rows

    nameghidaliasverify_flag
    科•••兽gh_021a2971bb29KeJiShouX1
    惠•••技gh_1306e540f3211
  4. 4CSV

    wechat_oa-account_search-sample.csv account_id,ghid,name,description,alias,avatar_url,verify_flag,biz,platform

A request with 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_idghidnamedescriptionaliasavatar_urlverify_flagbizplatform
nullgh_021a2971bb29科•••兽KeJiShouX1wechat_oa
nullgh_1306e540f321惠•••技1wechat_oa

Use cases

  • Build a list of accounts for an industry

    Set keyword to an industry term and read name and description in 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 ghid as account to account_profile.

  • Tell accounts with the same name apart

    Compare alias, verify_flag and description, then de-duplicate with ghid or biz.

  • Match article links to an account

    The __biz value in an article link is the biz value here, so you can use it to tell which account a set of articles belongs to.

Limits and gotchas

  • keyword is required and searches Official Accounts. It does not search articles or mini programs, and it does not search personal WeChat contacts.
  • limit is capped at 400 rows per call; this capability has no paging parameter.
  • alias is the custom WeChat ID of the account and may be empty.
  • verify_flag is 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, account takes ghid (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.

CallsCost
10,000$160.00
100,000$1,600.00
1,000,000$16,000.00

Totals use the list price per call.

Code samples

#
bash
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.

POST

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYeswechat_oaPlatform identifier, fixed value.
actionbodystringYesaccount_searchCapability identifier, fixed value.
keywordbody.paramsstringYes-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.
limitbody.paramsinteger (1–400)No20The 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

#
Captured October 24, 2026 at 18:28 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
account_idOfficial Account ID (its WeChat ID).
ghidKeeps the platform's own meaning
nameName of the object itself, for account, product and business capabilities.
descriptionSummary or description, usually shorter than text.
aliasKeeps the platform's own meaning
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
verify_flagKeeps the platform's own meaning
bizKeeps the platform's own meaning
platformSource 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.

Errors

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.

You can call the other WeChat Official Accounts endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy