[中文]

用途:

把对外可见的视频号 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.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.tikhub.io/api/v1/wechat_channels/v2/fetch_channel_id_to_username' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "channel_id": "sphi9BjV8GK0Zsl", "raw": false }'

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

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

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简）:

`raw=true`（原始）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified):

`raw=true` (raw):

Request

Responses

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

[中文]#

用途:#

参数:#

返回:#

响应结构与 JSON Path:#

raw=false（精简）:#

raw=true（原始）:#

[English]#

Purpose:#

Parameters:#

Return:#

Response structure & JSON Path:#

raw=false (simplified):#

raw=true (raw):#

Request

Responses

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简）:

`raw=true`（原始）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified):

`raw=true` (raw):