WeChat Get Account Profile
## Purpose Look up a WeChat Official Account profile using its username, including available nickname, IP region, account type, original-article statistics and linked WeChat Channels identity. ## Inputs - `request_body` is required. - `request_body.username` is required. Supports `gh_…`, `gh_…@app` and custom WeChat IDs such as `nikejdi`. Example: `gh_363b924965e9`. Use an account username, not a display nickname or article URL. It may be obtained from article-detail `data.content.user_name` or account-search `jumpInfo.userName`. - `request_body.raw` is optional and defaults to `true`. Set it to `false` for simplified fields, or use `true` for the original response structure. ## Results and limitations Profile information is returned in `data`. - With `raw=false`, key paths include `$.data.user_name`, `$.data.nick_name`, `$.data.user_role`, `$.data.service_type`, `$.data.ban_type` (0 means normal), `$.data.ip_wording`, `$.data.original_article_count`, `$.data.original_content_str`, `$.data.finder_nickname` and `$.data.finder_username`. - With `raw=true`, `data` contains the original nested profile structure, including `accountInfo`, `baseInfo`, `statInfo` and `videoFinderInfo`; IP region is at `$.data.ipwording`. Simplified field paths do not apply to this mode. - This tool cannot retrieve an account biography/signature or avatar. In simplified output, `$.data.signature` and `$.data.head_url` are always `null`, and `$.data.unavailable` lists `signature` and `head_url`. These values indicate a retrieval limitation, not that the account has left those fields empty. Other fields may also be sparse or null. - Responses may be slow; a client timeout of 30 seconds is recommended.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 查询微信公众号资料的请求体对象:username 用于指定公众号账号;可选 raw 控制返回原始响应(true,默认)或精简解析结构(false)。 | — |
request_body.raw | boolean | No | True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure | true |
request_body.username | string | Yes | 公众号 username。三种形态都支持:`gh_…`、`gh_…@app`(关联小程序的账号)、以及自定义微信号(如 `nikejdi`)。取自文章详情接口响应的 `$.data.content.user_name`/Official account username. Three forms are supported: `gh_…`, `gh_…@app` (mini-program-linked accounts) and custom WeChat IDs (e.g. `nikejdi`). Taken from `$.data.content.user_name` of the article detail endpoints | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_wechat_get_account_profile' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"raw": false,
"username": "gh_6fcb4bb9eb1f"
}
}
}'{
"code": 200,
"data": {
"ban_type": 0,
"debug_id": "14408648",
"debug_info": "[REDACTED]",
"finder_nickname": null,
"finder_username": null,
"head_url": null
},
"docs": "https://api.tikhub.io/#/WeChat-Media-Platform-V2-API/fetch_account_profile_api_v1_wechat_mp_v2_fetch_account_profile_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"raw": false,
"username": "gh_6fcb4bb9eb1f"
}
}This example shows part of the response. Copied content is valid JSON.


