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 URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Request body
Example request
{
"username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder"
}Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info