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

[中文]

用途:

• 获取创作者的主页资料与互动统计。与 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).

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.