WeChat Get Account Profile

20.65 credits/call
ae_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.

Social
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes查询微信公众号资料的请求体对象:username 用于指定公众号账号;可选 raw 控制返回原始响应(true,默认)或精简解析结构(false)。—
request_body.rawbooleanNoTrue=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structuretrue
request_body.usernamestringYes公众号 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.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.