WeChat Resolve Channel ID To Username
Resolve a WeChat Channels short ID (`sph...`) to a finder username (`v2_...@finder`) for use in later account or video queries. Inputs: - `request_body` is required. - `request_body.channel_id` is required: a short ID such as `sphi9BjV8GK0Zsl`. It must match `^sph[A-Za-z0-9_-]+$` and be no longer than 64 characters. - `request_body.raw` is optional and defaults to `false` in the input schema. Use `false` for simplified output or `true` for raw grouped results. Returns: - With `raw=false`, `data.channel_id` echoes the input; `data.username` contains the resolved finder username; `data.nickname` contains the nickname without search highlighting; and `data.desc` contains the account description, which may be null. The simplified result uses the first `@finder` account item found in the raw groups. If no match is found, `data.username` is null and `data.error` explains why. - With `raw=true`, `data.data` contains result groups with account items under `items` or `subBoxes[].items`. Account usernames appear in `jumpInfo.userName` or `noticeParam.finderUsername` within an item; `title` and `desc` contain display text. The response can be slow. Set the client request timeout to 30 seconds; timeout is not a tool input. This tool resolves an account identifier, not the account's video list.
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 | 用于将视频号短 ID 解析为 finder username 的请求体对象;channel_id 指定待解析的 sph 开头短号,raw 可选,用于选择原始响应(true)或精简解析结果(false)。 | — |
request_body.raw | boolean | No | True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure | false |
request_body.channel_id | string | Yes | 视频号 ID(sph 开头的短号)/WeChat Channels ID (short ID starting with sph) | — |
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_resolve_channel_id_to_username' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"channel_id": "sphuqLkqto4uNsU",
"raw": false
}
}
}'{
"code": 200,
"data": {
"debug_id": "201d1116",
"debug_info": "[REDACTED]",
"empty_reason": "bad_input",
"message": "请求参数可能有误(如无效的文章 URL / finder username / 视频 object_id),请检查参数后重试。注意:使用无效参数的请求被微信处理后仍会计费。"
},
"docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_channel_id_to_username_api_v1_wechat_channels_v2_fetch_channel_id_to_username_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"channel_id": "sphuqLkqto4uNsU",
"raw": false
}
}This example shows part of the response. Copied content is valid JSON.






