WeChat Get User Profile
## Purpose Get a WeChat Channels creator's homepage profile and account-level interaction statistics. ## Inputs Provide the required `request_body` object: - `username` (required): finder username in `v2_…@finder` format, matching `^v2_[0-9a-fA-F]+@finder$`, with a total length of 10–256 characters. Use the username obtained from video data, or convert an `sph…` short ID first. A nickname or short ID cannot be supplied directly. - `raw` (optional boolean, default `true`): `true` returns the full nested raw response; `false` returns a simplified, flattened profile using snake_case field names. ## Results Profile information is returned in `data`. With `raw=false`, fields include: - `username`, `nickname`, `signature`, `head_url`, and `region`: account identity, biography, avatar URL, and IP region. - `fans_count`, `feeds_count`, `like_count`, `fav_count`, `forward_count`, and `friend_follow_count`: follower, video, like, favorite, forward, and friend-follow counts. - `live_duration_hours`: accumulated live-streaming duration in hours. - `original_flag`, `collection_count`, and `verify_desc`: original-content flag, number of collections, and verification description, which may be null. - `linked_accounts`: linked official accounts with `nickname` and `type`. With `raw=true`, profile fields are nested under `data.contact`; counts include `data.fansCount`, `data.feedsCount`, `data.feedsLikeCount`, `data.feedsFavCount`, and `data.feedsForwardCount`. IP region is at `data.ipRegionInfo.regionText`, collection count at `data.collectionListInfo.collectionCount`, and linked-account details at `data.bizInfo.info`. The raw response also includes first-page video and live-session information; it is not a complete video listing. ## Notes Some accounts return 0 for follower or interaction counts; do not assume these values prove there is no audience or activity. This lookup is for profile data, not dedicated verification-entity/license information or collection details. Results are returned directly, without polling. Responses may be slow; a 30-second client request timeout is recommended where configurable.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
Each call has a fixed charge of 20.65 credits. 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(v2_…@finder 格式的 finder username)及可选的 raw(默认 true,返回原始响应;false 返回精简解析结构)。 | — |
request_body.raw | boolean | No | True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure | true |
request_body.username | string | Yes | 视频号 finder username(v2_…@finder 格式)/WeChat Channels finder username (v2_…@finder format) | — |
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_user_profile' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"raw": false,
"username": "v2_060000231003b20faec8c4e0801fc5d5c80deb32b0778e2433867b616dbc888e5a8c72a457a2@finder"
}
}
}'{
"code": 200,
"data": {
"collection_count": null,
"debug_id": "47a09566",
"debug_info": "[REDACTED]",
"fans_count": 0,
"fav_count": 0,
"feeds_count": 463
},
"docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_user_profile_api_v1_wechat_channels_v2_fetch_user_profile_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"raw": false,
"username": "v2_060000231003b20faec8c4e0801fc5d5c80deb32b0778e2433867b616dbc888e5a8c72a457a2@finder"
}
}This example shows part of the response. Copied content is valid JSON.






