WeChat Official Accounts details API

Read the basic profile of one Official Account by account: name, account_type (subscription or service account), description, avatar_url, account_id and biz, for $8 per 1,000 calls.

WeChat Official Account details reads the public profile of the account named in account: its name, description, avatar, account type and two identifiers, account_id and biz. It tells you which account you are dealing with and what kind it is, for teams that vet accounts before a partnership, keep a directory of media accounts, or need a fixed key to join articles and comments to the account that published them.

account_type tells subscription accounts apart from service accounts, so you can filter or compare the two kinds separately. description is the account's own short introduction, useful for classifying accounts by topic, and name is the display name, which is not the same thing as the WeChat ID you may have passed in. biz is the __biz value carried in the account's article links, which makes it the field that ties article URLs back to this profile.

  • account takes a WeChat ID, the original ID that starts with gh_, or an account or article link that identifies the account.
  • biz is the same value as __biz in the account's article links.
  • 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
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "wechat_oa",
      "action": "account_profile",
      "params": {
        "account": "36氪"
      }
    }
  2. 2JSON response

    {
      "results": {
        "account_id": "gh_240fbf8b33e4",
        "name": "36氪",
        "account_type": "订阅号",
        …
      }
    }
  3. 3Fields

    account_idnameaccount_type
    gh_240fbf8b33e436氪订阅号
  4. 4CSV

    wechat_oa-account_profile-sample.csv account_id,name,account_type,description,avatar_url,biz,platform

A request with account goes in, and one JSON object comes back; name and account_type are among its fields, listed as a field table and a CSV file.

What data you get

The table shows a real call for 36氪, captured October 24, 2026 at 19:16 (UTC), that returned one object. Your own calls return these fields as listed in the field reference.

account_idnameaccount_typedescriptionavatar_urlbizplatform
gh_240fbf8b33e436氪订阅号nullnullnullwechat_oa

Use cases

  • Tell subscription and service accounts apart

    Read account_type and split the accounts on your list into subscription accounts and service accounts.

  • Keep a record for each account

    Store account_id, name, description and biz, and later match the __biz in an article link back to the record.

  • Complete accounts found by search

    After account_search returns candidates, pass the ghid as account here to add account_type.

WeChat Open Platform interface for authorized account details vs EveryInfra

Here is how the "get authorized account details" interface in WeChat Open Platform and EveryInfra account_profile compare on basic information and account type.

ComparedWeChat Open Platform interface for authorized account detailsEveryInfra
Basic informationThe page says the API gets the basic information of the authorizer, including the avatar, nickname, account type, verification type, original ID and more.avatar_url, name, account_type, account_id, description and biz. Verification type and owner details are in account_principal.
Account typeservice_type_info is the type of the Official Account or mini program. In the type ID values, 0 is a subscription account and 2 is a service account.account_type returns the subscription or service account type directly.

WeChat Open Platform documentation is in Chinese. The table shows a translation of the page for authorized account details, checked on 2026-11-22; the page shows no update date. The official interface lets only a third-party platform read an authorized account, with component_access_token. Official sources: Get authorized account details

Limits and gotchas

  • account is required. It takes the account's WeChat ID, the original ID that starts with gh_, or an account or article link that identifies the account. A personal WeChat ID does not work.
  • account_type is a subscription or service account. It does not show verification status; read account_principal for verification and owner details.
  • biz is the value of the __biz parameter in article links, and the article links of one account carry the same value.
  • One call reads one account.

Pricing

You pay $0.008 per call, not per row. Failed calls and empty results are not charged.

CallsCost
10,000$80.00
100,000$800.00
1,000,000$8,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_profile",
  "params": {
    "account": "36氪"
  }
}'

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_profile, 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 details endpoint (wechat_oa/account_profile).

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_profile, and put the parameters inside params.
- Required parameters:
  - account: Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs.
- Returns one object. Main fields: account_id (Official Account ID (its WeChat ID)), name, account_type, description, avatar_url, biz.
- Example request body:
{
  "platform": "wechat_oa",
  "action": "account_profile",
  "params": {
    "account": "36氪"
  }
}
- Price: $8 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_profileCapability identifier, fixed value.
accountbody.paramsstringYes-Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today).

Response example

#
Captured October 24, 2026 at 19:16 (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. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "wechat_oa",  "action": "account_profile",  "results": {    "account_id": "gh_240fbf8b33e4",    "name": "36氪",    "account_type": "订阅号",    "platform": "wechat_oa"  },  "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).
nameName of the object itself, for account, product and business capabilities.
account_typeKeeps the platform's own meaning
descriptionSummary or description, usually shorter than text.
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
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: Account Type, Verification Type, and Principal Entity Name ↗

    Official WeChat documentation separately details account types, verification types, and principal entity names; account display names are distinct from principal entity names. This reference only aligns terminology, does not imply official account management authorization, and does not copy WeChat access_token or appid values into parameters for this API.

    Checked 2026-09-04

FAQ

Which identifier should I use for account?

The gh_ raw ID is the most precise choice, since it is unique within WeChat. The account's WeChat ID, or a link that resolves to the account such as one of its article URLs, also works. A personal WeChat ID belongs to an individual user rather than an Official Account, so it cannot be looked up here.

What is biz used for?

biz is the value of the __biz parameter that appears in the account's article links on mp.weixin.qq.com. Store it with the profile: when you later collect article links from search results or shares, the __biz in each link tells you which account published it without relying on the display name.

How do I find out who owns an account?

This capability returns the public profile only. Pass the same account value to the WeChat Account owner capability for the company or person registered behind the account, and to Account articles or Today's account articles for what the account publishes.

Which fields does Account details return?

account_id, name, account_type, description, avatar_url and biz.

How much does one account cost?

It costs $0.008 per call, or $8 per 1,000 calls, and one call reads one account. 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