获取直播数据详情 | 微信开放文档

# 获取直播数据详情

# 接口调用请求说明

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

# 请求参数示例

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

# 回包示例

{
    "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
}

# 请求参数说明

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

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

# 回包参数说明

参数	类型	说明
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	是否还有直播

# 错误码

错误码	错误信息
公共错误码	点击查看
-2	请求的参数错误
1	请求的信息不存在
100000	没有权限访问