Wechat-Channels-V2/微信视频号V2

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

POST

https://api.getoneapi.com/api/wechat-channels-v2/fetch_collection_video_list

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

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

重要提示（视频下载与解密）:

直接访问响应里的 url 无法打开视频页面，因为微信视频号做了防盗链加密。把 url 和 url_token 拼成完整 URL（或直接使用full_url）再用任意 HTTP 客户端下载（能打开 = HTTP 200，不代表能播放，文件是加密的）。
⚠️ 视频文件加密说明: 下载的 MP4 若无法播放即为加密文件。请使用接口返回的 decode_key 字段和加密视频文件进行解密。
⚠️ 重要: 微信每次请求都返回新的加密链接和 decode_key（即使同一视频）。务必保证 decode_key 与下载的加密文件来自同一次 API 响应，否则解密失败。

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

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

topic_id string 必需

合集 ID（纯数字，来自 fetch_user_collection_list的 topic_id）。示例 14903663452978350237

topic string 可选

可选，合集名，提高命中。示例廿四帧光阴里的哲学

username string 可选

可选，创作者 finder username（v2_…@finder 格式），提高命中

last_buffer string 可选

可选，翻页游标（base64），首页留空；当响应 down_continue 为真时，传上一页响应的 last_buffer 取下一页。

topic_type string 可选

可选，合集类型，默认 16（与 fetch_user_collection_list里该合集的 topic_type 对齐）。

raw boolean 可选

可选，默认 false。true=原始；false=精简解析。

示例

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

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

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

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

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
}'

更新于 2026-11-10 19:04:48