视频号ID转finder username/Convert Channel ID to Finder Username

[中文]

用途:

• 把对外可见的视频号 ID（sph… 短号）解析成 finder username（v2_…@finder）。
• 拿到 username 后即可调用 fetch_user_videos、fetch_channel_info、fetch_user_profile 等接口。
• 价格：0.01$/次
• ⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

参数:

• channel_id: 视频号 ID（sph… 短号），示例 sphi9BjV8GK0Zsl（人民日报）。要求为 sph 开头的短号。
• raw: 可选，默认 True。True=原始响应；False=精简解析结构。

返回:

• 解析出的 finder username 及账号昵称、简介

响应结构与 JSON Path:

raw=false（精简）:

• 入参回显: $.data.channel_id
• 解析出的 finder username（可直接喂下游接口）: $.data.username
• 账号昵称（已剥离搜索高亮标记）: $.data.nickname
• 账号简介: $.data.desc（可能为 null）
• 未命中时: $.data.username 为 null，且带 $.data.error 说明

raw=true（原始）:

• 结果分组: $.data.data[N]（每组 type + items[] / subBoxes[].items[]）
• 账号项里的 finder username: $.data.data[N].items[M].jumpInfo.userName 或 $.data.data[N].items[M].noticeParam.finderUsername
• 标题 / 简介: $.data.data[N].items[M].title / .desc
• 其它: $.data.query（回显查询）、$.data.continueFlag、$.data.offset
• 对应关系: raw=false 的 username / nickname / desc 即从 raw=true 的 data[].items[]（或 subBoxes[].items[]）中首个 @finder 账号项提取。

[English]

Purpose:

• Resolve a publicly visible Channel ID (sph… short ID) into a finder username (v2_…@finder).
• With the username you can then call fetch_user_videos, fetch_channel_info, fetch_user_profile, etc.
• Price: $0.01 per request
• ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.

Parameters:

• channel_id: Channel ID (sph… short ID), e.g. sphi9BjV8GK0Zsl (People's Daily). Must start with sph.
• raw: Optional, default True. True=raw response; False=simplified parsed structure.

Return:

• Resolved finder username plus account nickname and description

Response structure & JSON Path:

raw=false (simplified):

• Input echo: $.data.channel_id
• Resolved finder username (feed directly into downstream endpoints): $.data.username
• Account nickname (search highlight markers stripped): $.data.nickname
• Account description: $.data.desc (may be null)
• On miss: $.data.username is null with an explanation at $.data.error

raw=true (raw):

• Result groups: $.data.data[N] (each group has type + items[] / subBoxes[].items[])
• Finder username inside account items: $.data.data[N].items[M].jumpInfo.userName or $.data.data[N].items[M].noticeParam.finderUsername
• Title / description: $.data.data[N].items[M].title / .desc
• Others: $.data.query (query echo), $.data.continueFlag, $.data.offset
• Mapping: username / nickname / desc of raw=false are extracted from the first @finder account item in data[].items[] (or subBoxes[].items[]) of raw=true.

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.