WeChat Resolve Channel ID To Username

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

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用于将视频号短 ID 解析为 finder username 的请求体对象;channel_id 指定待解析的 sph 开头短号,raw 可选,用于选择原始响应(true)或精简解析结果(false)。—
request_body.rawbooleanNoTrue=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structurefalse
request_body.channel_idstringYes视频号 ID(sph 开头的短号)/WeChat Channels ID (short ID starting with sph)—

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