[中文]

用途:

获取创作者主页的「合集」列表。每个合集的 topic_id 可传 fetch_collection_videos 取该合集内的视频。

⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

⚠️ 大整数 ID 精度：响应中的 topic_id 等为 64 位大整数，超出 JavaScript 安全整数范围（2^53-1）。请始终以字符串方式接收 / 传递这类 ID（解析 JSON 用 json-bigint 或按文本取值），勿让其经过 JS Number。Swagger UI 文档页对超大整数会末位舍入显示，属正常现象，不影响接口实际返回的数据。

参数:

username: 视频号 finder username（v2_…@finder 格式）。示例 v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder（人民日报）。

raw: 可选，默认 True。True=原始响应；False=精简解析结构。

合集列表

响应结构与 JSON Path:

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

$.data.username —— finder username

$.data.count —— 合集总数（示例 6）

$.data.collections[] —— 合集数组，逐个（N 为下标）:

$.data.collections[N].topic_id —— 合集 ID（纯数字，传 fetch_collection_videos，示例 14616794565351966924）

$.data.collections[N].name —— 合集名（如「早安中国」）

$.data.collections[N].desc —— 合集简介（可能为空串）

$.data.collections[N].cover_url —— 合集封面

$.data.collections[N].feed_count —— 合集内视频数

$.data.collections[N].topic_type —— 合集类型（示例 16，与 fetch_collection_videos 的 topic_type 对应）

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

$.data.collectionCount → count

$.data.collectionInfo[] → collections[]，逐个:

$.data.collectionInfo[N].collectionTopicId → topic_id（数字；另有 collectionTopicIdStr 字符串别名）

$.data.collectionInfo[N].collectionName → name

$.data.collectionInfo[N].collectionDesc → desc

$.data.collectionInfo[N].coverImgUrl → cover_url

$.data.collectionInfo[N].feedCount → feed_count

$.data.collectionInfo[N].collectionTopicType → topic_type

另含 lastUpdateTime / readCount / categoryId 等原始字段

$.data.lastBuffer —— 合集列表翻页游标（通常为空，合集数少不需翻页）

[English]

Purpose:

Get the "Collections" list on a creator's homepage. Pass each collection's topic_id to fetch_collection_videos to get its videos.

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

⚠️ Large-integer ID precision: IDs such as topic_id in the response are 64-bit big integers beyond JavaScript's safe-integer range (2^53-1). Always receive / pass such IDs as strings (parse JSON with json-bigint or read them as text), never through JS Number. Swagger UI rounds the trailing digits of huge integers in its docs view — this is expected and does not affect the actual data returned by the API.

Parameters:

username: WeChat Channels finder username (v2_…@finder format). E.g. v2_060000231003b20faec8c6e4811dc1d4c602ee30b0771bbcf220c67926bb76ab7702ac335a53@finder (People's Daily).

raw: Optional, default True. True=raw response; False=simplified parsed structure.

Return:

Collection list

Response structure & JSON Path:

`raw=false` (simplified, snake_case):

$.data.username — finder username

$.data.count — total collections (e.g. 6)

$.data.collections[] — collection array, per item (N is the index):

$.data.collections[N].topic_id — collection ID (numeric, pass to fetch_collection_videos, e.g. 14616794565351966924)

$.data.collections[N].name — collection name (e.g. "早安中国")

$.data.collections[N].desc — collection description (may be empty string)

$.data.collections[N].cover_url — collection cover

$.data.collections[N].feed_count — number of videos in the collection

$.data.collections[N].topic_type — collection type (e.g. 16, matches topic_type of fetch_collection_videos)

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

$.data.collectionCount → count

$.data.collectionInfo[] → collections[], per item:

$.data.collectionInfo[N].collectionTopicId → topic_id (number; collectionTopicIdStr provides a string alias)

$.data.collectionInfo[N].collectionName → name

$.data.collectionInfo[N].collectionDesc → desc

$.data.collectionInfo[N].coverImgUrl → cover_url

$.data.collectionInfo[N].feedCount → feed_count

$.data.collectionInfo[N].collectionTopicType → topic_type

Also raw fields like lastUpdateTime / readCount / categoryId

$.data.lastBuffer — pagination cursor of the collection list (usually empty; few collections, no pagination needed)

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 Collections

[中文]

用途:

参数:

返回:

响应结构与 JSON Path:

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

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

[English]

Purpose:

Parameters:

Return:

Response structure & JSON Path:

`raw=false` (simplified, snake_case):

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

TikOmni Pricing

Request

Request Code Samples

Responses

获取视频号合集列表/Get WeChat Channels User Collections

[中文]#

用途:#

参数:#

返回:#

响应结构与 JSON Path:#

raw=false（精简，snake_case）:#

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

[English]#

Purpose:#

Parameters:#

Return:#

Response structure & JSON Path:#

raw=false (simplified, snake_case):#

raw=true (full raw response, 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, snake_case):

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

TikOmni Pricing