[中文]

用途:

获取创作者的主页资料与互动统计。与 fetch_channel_info（认证主体 / 许可证）互补：本接口给昵称 / 签名 / 头像、粉丝 / 作品 / 获赞 / 收藏 / 转发数、直播时长、IP 属地、合集数、关联公众号等。

⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（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.

⏱️ 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).

TikOmni Pricing

Actual billing follows the TikOmni pricing catalog. Query /api/pricing/v1/endpoints with this endpoint path for the current unit price.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "username": "v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder",
    "raw": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简，snake_case 拍平）:

`raw=true`（完整原始响应，camelCase 嵌套）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified, flattened snake_case):

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

TikOmni Pricing

Request

Request Code Samples

Responses

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

[中文]#

用途:#

参数:#

返回:#

响应结构与 JSON Path:#

raw=false（精简，snake_case 拍平）:#

raw=true（完整原始响应，camelCase 嵌套）:#

[English]#

Purpose:#

Parameters:#

Return:#

Response structure & JSON Path:#

raw=false (simplified, flattened snake_case):#

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

TikOmni Pricing#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

`raw=false`（精简，snake_case 拍平）:

`raw=true`（完整原始响应，camelCase 嵌套）:

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified, flattened snake_case):

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

TikOmni Pricing