WeChat-Channels-V2-API

获取视频号账号主页资料+统计/Get WeChat Channels User Profile & Stats

Changed on

[中文]

用途:

  • 获取创作者的主页资料与互动统计。与 fetch_channel_info(认证主体 / 许可证)互补:本接口给昵称 / 签名 / 头像、粉丝 / 作品 / 获赞 / 收藏 / 转发数、直播时长、IP 属地、合集数、关联公众号等。
  • 价格:0.01$/次
  • ⏱️ 由于微信服务器原因,本接口响应较慢,请将客户端请求超时(timeout)设置为 30 秒;timeout 设置过小会造成已扣费但收不到响应的情况。

参数:

  • username: 视频号 finder username(v2_…@finder 格式)。来源:fetch_video_detail、fetch_user_videos 响应里视频对象的 username;或 fetch_channel_id_to_username 把 sph… 短号转成 username。示例 v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder(人民日报)。
  • raw: 可选,默认 True。True=原始响应;False=精简解析结构。

返回:

  • 账号主页资料与互动统计

响应结构与 JSON Path:

raw=false(精简,snake_case 拍平):

  • $.data.username —— finder username
  • $.data.nickname / $.data.signature / $.data.head_url(头像)/ $.data.region(IP 属地,如「北京」)
  • $.data.fans_count —— 粉丝数。注意:部分账号(如人民日报)返回 0
  • $.data.feeds_count —— 作品数(示例 10555)
  • $.data.like_count / $.data.fav_count / $.data.forward_count —— 获赞 / 收藏 / 转发数(部分账号为 0)
  • $.data.friend_follow_count —— 好友关注数
  • $.data.live_duration_hours —— 累计直播时长(小时)
  • $.data.original_flag —— 原创标记
  • $.data.collection_count —— 合集数(示例 6;明细走 fetch_user_collections)
  • $.data.verify_desc —— 认证说明(可能为 null)
  • $.data.linked_accounts[] —— 关联公众号 [{nickname, type}](如 {"nickname":"人民日报","type":"公众号"})

raw=true(完整原始响应,camelCase 嵌套):

  • $.data.contact.nickname / .signature / .headUrl → nickname / signature / head_url
  • $.data.contact.username → username;$.data.contact.originalFlag → original_flag
  • $.data.contact.authInfo(authProfession / authIconType …)—— 认证信息
  • $.data.ipRegionInfo.regionText → region
  • $.data.fansCount → fans_count(同样部分账号为 0);$.data.feedsCount → feeds_count
  • $.data.feedsLikeCount / .feedsFavCount / .feedsForwardCount → like_count / fav_count / forward_count
  • $.data.liveDurationHours → live_duration_hours;$.data.collectionListInfo.collectionCount → collection_count
  • $.data.bizInfo.info[](bizNickname / serviceTypeName)→ linked_accounts[]
  • 另含 $.data.object[](首屏作品列表)、$.data.anchorStatInfo(直播场次统计)、$.data.lastBuffer / $.data.continueFlag(首屏作品翻页用,本接口只取资料故一般不用)等几十个字段。

[English]

Purpose:

  • Get a creator's homepage profile and interaction stats. Complementary to fetch_channel_info (verification entity / license): this endpoint provides nickname / signature / avatar, follower / video / like / favorite / forward counts, live duration, IP region, collection count, linked official accounts, 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:

  • username: WeChat Channels finder username (v2_…@finder format). Source: the username field of video objects in fetch_video_detail / fetch_user_videos responses; or convert a sph… short ID via fetch_channel_id_to_username. E.g. v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder (People's Daily).
  • raw: Optional, default True. True=raw response; False=simplified parsed structure.

Return:

  • Account homepage profile and interaction stats

Response structure & JSON Path:

raw=false (simplified, flattened snake_case):

  • $.data.username — finder username
  • $.data.nickname / $.data.signature / $.data.head_url (avatar) / $.data.region (IP region, e.g. "北京")
  • $.data.fans_count — follower count. Note: some accounts (e.g. People's Daily) return 0
  • $.data.feeds_count — video count (e.g. 10555)
  • $.data.like_count / $.data.fav_count / $.data.forward_count — like / favorite / forward counts (0 for some accounts)
  • $.data.friend_follow_count — friend-follow count
  • $.data.live_duration_hours — accumulated live streaming hours
  • $.data.original_flag — original-content flag
  • $.data.collection_count — collection count (e.g. 6; details via fetch_user_collections)
  • $.data.verify_desc — verification description (may be null)
  • $.data.linked_accounts[] — linked official accounts [{nickname, type}] (e.g. {"nickname":"人民日报","type":"公众号"})

raw=true (full raw response, nested camelCase):

  • $.data.contact.nickname / .signature / .headUrl → nickname / signature / head_url
  • $.data.contact.username → username; $.data.contact.originalFlag → original_flag
  • $.data.contact.authInfo (authProfession / authIconType …) — verification info
  • $.data.ipRegionInfo.regionText → region
  • $.data.fansCount → fans_count (also 0 for some accounts); $.data.feedsCount → feeds_count
  • $.data.feedsLikeCount / .feedsFavCount / .feedsForwardCount → like_count / fav_count / forward_count
  • $.data.liveDurationHours → live_duration_hours; $.data.collectionListInfo.collectionCount → collection_count
  • $.data.bizInfo.info[] (bizNickname / serviceTypeName) → linked_accounts[]
  • Also contains dozens of raw fields like $.data.object[] (first-screen video list), $.data.anchorStatInfo (live session stats), $.data.lastBuffer / $.data.continueFlag (pagination of the first-screen videos; generally unused here since this endpoint is for profile data).
post/api/v1/wechat_channels/v2/fetch_user_profile

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