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

微信视频号作品列表

POST

https://api.getoneapi.com/api/wechat-channels-v2/fetch_user_video_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

username string 视频号 finder username 必需

v2_…@finder 格式，示例：v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder
获取途径：
1.通过fetch_video_detail 响应里每个视频对象的 username 字段获取。
2.通过fetch_channel_id_to_username 把视频号 ID（sph… 短号，如 sphilT1fCLWHKd7）转成 username

last_buffer string 可选

可选，翻页游标（base64）。首页留空；当响应 up_continue 为真时，传上一页响应的 last_buffer 取下一页。（base64 含 +//= 等字符，故走 body 而非 query。）

raw boolean 可选

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

示例

{
  "username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "last_buffer" : "",
  "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_user_video_list' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "last_buffer" : "",
  "raw" : false
}'

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