WeChat-Channels-V2-API

获取视频号账号信息/Get WeChat Channels Account Info

Changed on

[中文]

用途:

  • 获取指定视频号账号的「更多信息」:基础信息分区(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.
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)
  • Auth
    HTTP bearer

Request body

usernamestring required

视频号 finder username(v2_…@finder 格式)/WeChat Channels finder username (v2_…@finder format)

rawboolean

True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure

Example request

{
  "username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"
}

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes