---
title: "获取视频号账号主页资料+统计/Get WeChat Channels User Profile & Stats"
method: POST
path: "/api/v1/wechat_channels/v2/fetch_user_profile"
tags: ["WeChat-Channels-V2-API"]
---

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

`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)
- URL: `https://api.tikhub.io/api/v1/wechat_channels/v2/fetch_user_profile`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取创作者的主页资料与互动统计。与 `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).

## Request body

- FetchUserProfileRequest
  - `username` string, required: 视频号 finder username（v2_…@finder 格式）/WeChat Channels finder username (v2_…@finder format)
  - `raw` boolean: True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/wechat_channels/v2/fetch_user_profile/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)