WeChat Get User Profile

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

Social
20.65 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes用于获取微信视频号创作者主页资料与互动统计的请求体对象。包含必填的 username(v2_…@finder 格式的 finder username)及可选的 raw(默认 true,返回原始响应;false 返回精简解析结构)。—
request_body.rawbooleanNoTrue=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structuretrue
request_body.usernamestringYes视频号 finder username(v2_…@finder 格式)/WeChat Channels finder username (v2_…@finder format)—

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_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"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.