微信视频号直播回放

POST

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

获取创作者的直播回放列表。回放本身就是视频对象，每条带媒体地址 media（含 url / url_token / decode_key），可直接下载解密。

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

请求参数

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），首页留空；当响应 continue_flag 为真时，传上一页响应的 last_buffer 取下一页。

flag integer 可选

可选，拉取标志，默认 12。

raw boolean 可选

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

示例

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

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