视频号助手API / 留资组件管理 / 获取留资组件直播推广记录信息详情

# 获取留资组件直播推广记录信息详情

# 接口说明

通过该接口可获取留资组件直播推广记录信息详情。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/leads/get_leads_component_promote_record?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
leads_component_id	string	是	用于查询某个留资组件某段时间内的直播推广记录信息
start_time	number	否	开始时间
end_time	number	否	结束时间
last_buffer	string	否	顺序翻页，传入上次请求返回的last_buffer, 会从上次返回的结果往后翻一页

# 请求参数示例

{
    "leads_component_id": "100234056999000000",
    "start_time": 0,
    "end_time": 1668676968,
    "last_buffer": "EB4YAg"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
record_data	array	留资组件直播推广记录列表
last_buffer	string	本次翻页的上下文，用于顺序翻页请求
continue_flag	boolean	是否还有直播推广记录信息

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "record_data": [
        {
            "anchor_nickname": "xxx",
            "live_description": "xxx",
            "live_start_time": 1688393984,
            "live_audience_count": "988",
            "exposure_uv": "6960",
            "click_uv": "233",
            "exposure_click_rate": 0.0334,
            "leads_num": "64"
            "close_flag": 1
        }
    ],
    "last_buffer": "EB4YAg=",
    "continue_flag": true
}

# 错误码

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