WeChat Official Accounts owner API

Read who is behind an Official Account by account: company_name, owner_name, customer_type, verify_status, verify_type, verified_at, plus registered_country, registered_at and is_overseas, for $5.56 per 1,000 calls.

  • customer_type is personal, enterprise, government or media.
  • authorized_agents lists the authorized agencies.
  • 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
32%
24h average time
36.17 s
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Mostly down

Last 24 hours

Last 30 days

  1. 1Request

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

    {
      "results": {
        "ghid": "gh_240fbf8b33e4",
        "name": "36氪",
        "company_name": "北京多氪信息科技有限公司",
        "verify_status": true,
        …
      }
    }
  3. 3Fields

    ghidnamecompany_nameverify_status
    gh_240fbf8b33e436氪北京多氪信息科技有限公司true
  4. 4CSV

    wechat_oa-account_principal-sample.csv account_id,ghid,name,description,company_name,owner_name,customer_type,verify_status,verify_type,verified_at,registered_country,registered_at,is_overseas,last_login_province,authorized_agents,platform

A request with account goes in, and one JSON object comes back; company_name and verify_status 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_idghidnamedescriptioncompany_nameowner_namecustomer_typeverify_statusverify_typeverified_atregistered_countryregistered_atis_overseaslast_login_provinceauthorized_agentsplatform
nullgh_240fbf8b33e436氪null北京多氪信息科技有限公司nullnulltruenullnullnullnullnullnullnullwechat_oa

Use cases

  • Check the owner before a partnership

    Read company_name and owner_name and see whether they match the owner the other side names.

  • Split enterprise and personal accounts

    Use customer_type to sort accounts into personal, enterprise, government and media.

  • Pick out accounts with an overseas owner

    is_overseas says whether the owner is overseas, registered_country is the country of registration and last_login_province is the province of the latest login.

  • Read the verification and registration times

    verified_at is the verification time and registered_at is the registration time. Read the two fields on their own.

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_principal compare on the owner name and the verification type.

ComparedWeChat Open Platform interface for authorized account detailsEveryInfra
Owner nameprincipal_name is the name of the owner.company_name is the company name of the verified owner, and owner_name is the name of the operator.
Verification typeverify_type_info is the verification type of the Official Account or mini program. Its type ID values include -1 for not verified, 0 for WeChat verification and 1 for Sina Weibo verification.verify_status is the verification status, verify_type is the verification type and verified_at is the verification time.

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 and is written as in account_profile: a 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.
  • The avatar, the subscription or service account type and biz are not returned here. Read them from account_profile.
  • customer_type is the owner type: personal, enterprise, government or media.
  • verified_at and registered_at are the verification time and the registration time. They are two different times.
  • One call reads one account.

Pricing

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

CallsCost
10,000$55.56
100,000$555.56
1,000,000$5,555.56

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_principal",
  "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_principal, 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 owner endpoint (wechat_oa/account_principal).

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_principal, 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)), ghid, name, description, company_name, owner_name, customer_type, verify_status, verify_type, verified_at, registered_country, registered_at; 15 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa.
- Example request body:
{
  "platform": "wechat_oa",
  "action": "account_principal",
  "params": {
    "account": "36氪"
  }
}
- Price: $5.56 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_principalCapability 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_principal",  "results": {    "ghid": "gh_240fbf8b33e4",    "name": "36氪",    "company_name": "北京多氪信息科技有限公司",    "verify_status": true,    "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).
ghidKeeps the platform's own meaning
nameName of the object itself, for account, product and business capabilities.
descriptionSummary or description, usually shorter than text.
company_nameKeeps the platform's own meaning
owner_nameKeeps the platform's own meaning
customer_typeKeeps the platform's own meaning
verify_statusKeeps the platform's own meaning
verify_typeKeeps the platform's own meaning
verified_atKeeps the platform's own meaning
registered_countryKeeps the platform's own meaning
registered_atKeeps the platform's own meaning
is_overseasKeeps the platform's own meaning
last_login_provinceKeeps the platform's own meaning
authorized_agentsKeeps 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 fields does Account owner info return?

account_id, ghid, name, description, company_name, owner_name, customer_type, verify_status, verify_type, verified_at, registered_country, registered_at, is_overseas, last_login_province and authorized_agents.

What do I pass as account?

The account's WeChat ID, the original ID that starts with gh_, or an account or article link that identifies the account. If you only know the name, use account_search first and take ghid from the row you pick.

How is this different from account_profile?

This capability reads the owner side: company, operator, owner type, verification and registration. account_profile reads the account side: avatar, subscription or service account type and biz. Both take the same account.

How much does one account cost?

It costs $0.005556 per call, or $5.56 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