# 微信视频号合集内视频列表

`POST /api/wechat-channels-v2/fetch_collection_video_list`

给定合集 topic_id（来自 fetch_user_collection_list），返回该合集内的视频列表。

:::highlight yellow 💡
由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。
:::
:::highlight yellow 💡
重要提示（视频下载与解密）:
- 直接访问响应里的 url 无法打开视频页面，因为微信视频号做了防盗链加密。把 url 和 url_token 拼成完整 URL（或直接使用full_url） 再用任意 HTTP 客户端下载（能打开 = HTTP 200，不代表能播放，文件是加密的）。
- ⚠️ 视频文件加密说明: 下载的 MP4 若无法播放即为加密文件。请使用接口返回的 decode_key 字段和加密视频文件进行解密。
- ⚠️ 重要: 微信每次请求都返回新的加密链接和 decode_key（即使同一视频）。务必保证 decode_key 与下载的加密文件来自同一次 API 响应，否则解密失败。

免费在线解密工具: https://wc.getoneapi.com/
:::

## 鉴权

源接口未声明鉴权要求，请结合接入指南确认。

## 请求参数



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| Authorization | header | string | 是 | 在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey · default: "Bearer YOUR_API_KEY" |
| Content-Type | header | string | 是 |  · default: "application/json" |

## 请求体 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| topic_id | body | string | 是 | 合集 ID（纯数字，来自 fetch_user_collection_list的 topic_id）。示例 14903663452978350237 |
| topic | body | string | 否 | 可选，合集名，提高命中。示例 廿四帧光阴里的哲学 |
| username | body | string | 否 | 可选，创作者 finder username（v2_…@finder 格式），提高命中 |
| last_buffer | body | string | 否 | 可选，翻页游标（base64），首页留空；当响应 down_continue 为真时，传上一页响应的 last_buffer 取下一页。 |
| topic_type | body | string | 否 | 可选，合集类型，默认 16（与 fetch_user_collection_list里该合集的 topic_type 对齐）。 |
| raw | body | boolean | 否 | 可选，默认 false。true=原始；false=精简解析。 |

```json
{
  "type" : "object",
  "properties" : {
    "topic_id" : {
      "type" : "string",
      "description" : "合集 ID（纯数字，来自 fetch_user_collection_list的 topic_id）。示例 14903663452978350237"
    },
    "topic" : {
      "type" : "string",
      "description" : "可选，合集名，提高命中。示例 廿四帧光阴里的哲学"
    },
    "username" : {
      "type" : "string",
      "description" : "可选，创作者 finder username（v2_…@finder 格式），提高命中"
    },
    "last_buffer" : {
      "type" : "string",
      "description" : "可选，翻页游标（base64），首页留空；当响应 down_continue 为真时，传上一页响应的 last_buffer 取下一页。"
    },
    "topic_type" : {
      "type" : "string",
      "description" : "可选，合集类型，默认 16（与 fetch_user_collection_list里该合集的 topic_type 对齐）。"
    },
    "raw" : {
      "type" : "boolean",
      "description" : "可选，默认 false。true=原始；false=精简解析。"
    }
  },
  "required" : [ "topic_id" ]
}
```

```json
{
  "topic_id" : "14903663452978350237",
  "topic" : "廿四帧光阴里的哲学",
  "username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "last_buffer" : "",
  "topic_type" : 16,
  "raw" : false
}
```

## 响应 200 · application/json



| 字段 | 位置 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- | --- |
| code | body | integer | 是 |  |
| message | body | string | 是 |  |
| data | body | object | 是 |  |

```json
{
  "type" : "object",
  "properties" : {
    "code" : {
      "type" : "integer"
    },
    "message" : {
      "type" : "string"
    },
    "data" : {
      "type" : "object",
      "properties" : { }
    }
  },
  "required" : [ "code", "message", "data" ]
}
```

```json
{
  "code" : 200,
  "message" : "success",
  "data" : { }
}
```

## cURL

```sh
curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-channels-v2/fetch_collection_video_list' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "topic_id" : "14903663452978350237",
  "topic" : "廿四帧光阴里的哲学",
  "username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "last_buffer" : "",
  "topic_type" : 16,
  "raw" : false
}'
```