# 获取留资直播数据详情

# 接口说明

通过此接口可获取留资直播数据详情。

# 注意事项

该接口只包含2023.9.21号起,同时直播间有1min及以上的留资挂载才能导出对应直播数据。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/finderlive/get_finder_live_data_list?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
start_time number 查询范围的开始时间(与关播时间对比)
end_time number 查询范围的结束时间(与关播时间对比)
last_buffer string 顺序翻页,传入上次请求返回的last_buffer, 会从上次返回的结果往后翻一页

# 请求参数示例

{
    "start_time": 1694142436,
    "end_time": 1694228836,
    "last_buffer": "EB4YAg"
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
item[].export_id string 直播唯一id
item[].live_start_time number 开播时间戳
item[].live_duration_in_seconds number 直播时长
item[].total_audience_count number 观看人数
item[].total_cheer_count number 喝彩次数
item[].forward_count number 分享次数
item[].total_comment_count number 评论条数
item[].audiences_avg_seconds number 人均观看时长
item[].max_online_count number 最高在线人数
item[].new_follow_count number 新增粉丝
item[].new_follow_count_biz number 公众号新增粉丝
last_buffer string 本次翻页的上下文,用于顺序翻页请求
continue_flag boolean 是否还有直播

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "item": [
        {
            "export_id": "18881222222",
            "live_start_time": 1694142436,
            "live_duration_in_seconds": 3600,
            "total_audience_count": 10000,
            "total_cheer_count": 1000000,
            "forward_count": 1000,
            "total_comment_count": 10000,
            "audiences_avg_seconds": 600,
            "max_online_count": 200,
            "new_follow_count": 10,
            "new_follow_count_biz": 0
        }
    ],
    "last_buffer": "EB4YAg=",
    "continue_flag": true
}

# 错误码

错误码 错误描述
公共错误码 -
48001 接口权限未开启,需前往视频号助手- 开放能力-开放场景 打开开关
-2 请求的参数错误
1 请求的信息不存在
100000 没有权限访问