微信视频号直播间详情

POST

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

传直播 live_id 返回直播间详情：主播信息、直播状态、在线人数、回放信息等。

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

请求参数

Header 参数

Authorization string 必需

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

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

live_id string 必需

直播 ID（纯数字）。来源：fetch_live_history 的回放条目、直播入口或直播分享。示例 14932229425115766188。

scene integer 可选

可选，进入场景，默认 5。

finder_username string 可选

可选，主播 finder username（v2_…@finder 格式），提高命中。

raw boolean 可选

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

示例

{
  "live_id" : "14932229425115766188",
  "scene" : 5,
  "finder_username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "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_detail' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "live_id" : "14932229425115766188",
  "scene" : 5,
  "finder_username" : "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "raw" : false
}'

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