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_typeis personal, enterprise, government or media.authorized_agentslists 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
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "wechat_oa", "action": "account_principal", "params": { "account": "36氪" } }2JSON response
{ "results": { "ghid": "gh_240fbf8b33e4", "name": "36氪", "company_name": "北京多氪信息科技有限公司", "verify_status": true, … } }3Fields
ghid name company_name verify_status gh_240fbf8b33e4 36氪 北京多氪信息科技有限公司 true 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
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_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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
null | gh_240fbf8b33e4 | 36氪 | null | 北京多氪信息科技有限公司 | null | null | true | null | null | null | null | null | null | null | wechat_oa |
Use cases
Check the owner before a partnership
Read
company_nameandowner_nameand see whether they match the owner the other side names.Split enterprise and personal accounts
Use
customer_typeto sort accounts into personal, enterprise, government and media.Pick out accounts with an overseas owner
is_overseassays whether the owner is overseas,registered_countryis the country of registration andlast_login_provinceis the province of the latest login.Read the verification and registration times
verified_atis the verification time andregistered_atis 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.
| Compared | WeChat Open Platform interface for authorized account details | EveryInfra |
|---|---|---|
| Owner name | principal_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 type | verify_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
accountis required and is written as inaccount_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
bizare not returned here. Read them fromaccount_profile. customer_typeis the owner type: personal, enterprise, government or media.verified_atandregistered_atare 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.
| Calls | Cost |
|---|---|
| 10,000 | $55.56 |
| 100,000 | $555.56 |
| 1,000,000 | $5,555.56 |
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_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.
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
#| 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_principal | Capability identifier, fixed value. |
account | body.params | string | Yes | - | 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
#{ "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.
| 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. |
company_name | Keeps the platform's own meaning |
owner_name | Keeps the platform's own meaning |
customer_type | Keeps the platform's own meaning |
verify_status | Keeps the platform's own meaning |
verify_type | Keeps the platform's own meaning |
verified_at | Keeps the platform's own meaning |
registered_country | Keeps the platform's own meaning |
registered_at | Keeps the platform's own meaning |
is_overseas | Keeps the platform's own meaning |
last_login_province | Keeps the platform's own meaning |
authorized_agents | 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: 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.
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. - Account search
account_search$16 per 1,000 callsLook up WeChat Official Accounts by keyword, up to 400 per call. - 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 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.