--- title: "获取视频号账号信息/Get WeChat Channels Account Info" method: POST path: "/api/v1/wechat_channels/v2/fetch_channel_info" tags: ["WeChat-Channels-V2-API"] --- # 获取视频号账号信息/Get WeChat Channels Account Info `POST /api/v1/wechat_channels/v2/fetch_channel_info` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/wechat_channels/v2/fetch_channel_info` - Auth: HTTP bearer # [中文] ### 用途: - 获取指定视频号账号的「更多信息」：基础信息分区（IP 归属地 / 资料所在地 / **视频号 ID**=sph 公开号）+ 认证信息分区（服务单位 / 主体类型 / 互联网新闻信息服务许可证编号 / 服务类别 / 认证时间）。 - 价格：0.01$/次 - ⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。 ### 参数: - username: 视频号 finder username（`v2_…@finder` 格式），示例 `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder`（人民日报）。 - 怎么拿到它： - `fetch_video_detail`、`fetch_user_videos` 响应里每个视频对象的 `username` 字段（最常用） - `fetch_channel_id_to_username`：把视频号 ID（`sph…` 短号，如 `sphi9BjV8GK0Zsl`）转成 username - raw: 可选，默认 True。True=原始响应；False=精简解析结构。 ### 返回: - 视频号账号的基础信息与认证信息 ### 响应结构与 JSON Path: #### `raw=false`（精简）: - 账号 username: `$.data.finder_username` - 视频号 ID（sph 短号）: `$.data.channel_id` - 分区列表（原样保留分区结构）: `$.data.sections[N].title`、`$.data.sections[N].items[M].title` / `.content` - 扁平化后的「标题→内容」字典（最常用）: `$.data.info`，例如 `$.data.info['视频号ID']`、`$.data.info['IP归属地']`、`$.data.info['服务单位']`、`$.data.info['主体类型']`、`$.data.info['互联网新闻信息服务许可证编号']`、`$.data.info['服务类别']`、`$.data.info['认证时间']` #### `raw=true`（原始）: - 状态码: `$.data.baseResponse.ret`（0=成功） - 分区数组（camelCase）: `$.data.sections[N].title`、`$.data.sections[N].items[M].title` / `.content` / `.type` / `.jumpInfo` - 对应关系: raw=false 的 `info`/`channel_id` 对应 raw=true 的 `sections[].items[]`（按 title 扁平化、并剥离富文本图片标记）；raw=true **不含** `info` 扁平字典与 `channel_id`，需自行从 sections 提取。 # [English] ### Purpose: - Get the "More Info" of a WeChat Channels account: basic info section (IP location / profile location / **Channel ID** = public sph ID) + verification section (service unit / entity type / internet news service license number / service category / verification time). - 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: - username: WeChat Channels finder username (`v2_…@finder` format), e.g. `v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder` (People's Daily). - How to get it: - The `username` field of each video object in `fetch_video_detail` / `fetch_user_videos` responses (most common) - `fetch_channel_id_to_username`: convert a Channel ID (`sph…` short ID, e.g. `sphi9BjV8GK0Zsl`) into a finder username - raw: Optional, default True. True=raw response; False=simplified parsed structure. ### Return: - Basic info and verification info of the WeChat Channels account ### Response structure & JSON Path: #### `raw=false` (simplified): - Account username: `$.data.finder_username` - Channel ID (sph short ID): `$.data.channel_id` - Section list (original section structure preserved): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content` - Flattened "title→content" dict (most useful): `$.data.info`, e.g. `$.data.info['视频号ID']`, `$.data.info['IP归属地']`, `$.data.info['服务单位']`, `$.data.info['主体类型']`, `$.data.info['互联网新闻信息服务许可证编号']`, `$.data.info['服务类别']`, `$.data.info['认证时间']` #### `raw=true` (raw): - Status code: `$.data.baseResponse.ret` (0=success) - Section array (camelCase): `$.data.sections[N].title`, `$.data.sections[N].items[M].title` / `.content` / `.type` / `.jumpInfo` - Mapping: `info`/`channel_id` of raw=false correspond to `sections[].items[]` of raw=true (flattened by title with rich-text image markers stripped); raw=true does **not** contain the flattened `info` dict or `channel_id`, extract them from sections yourself. ## Request body - FetchChannelInfoRequest - `username` string, required: 视频号 finder username（v2_…@finder 格式）/WeChat Channels finder username (v2_…@finder format) - `raw` boolean: True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/wechat_channels/v2/fetch_channel_info/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)