# 获取账号收集的留资数量

# 接口说明

通过该接口可获取账号收集的留资数量。

# 注意事项

该接口只统计2023.9.13号起的数据,所以start_time应大于等于1694534400。

# 接口调用请求说明

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

# 请求参数说明

参数 类型 是否必填 描述
start_time number 查询范围的开始时间(与用户留资时间对比)
end_time number 查询范围的结束时间(与用户留资时间对比)
source_type number 来源类型,枚举值详情请参考source_type

# 请求参数示例

{
    "start_time": 1694142436,
    "end_time": 1694228836,
    "source_type": 0
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
item[].component_type number 组件类型,枚举值详情请参考component_type
item[].traffic_type number 流量来源,枚举值详情请参考traffic_type
item[].leads_count number 留资条数

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "item": [
        {
            "component_type": 0,
            "traffic_type": 0,
            "leads_count": 1000
        },
        {
            "component_type": 0,
            "traffic_type": 1,
            "leads_count": 1000
        },
        {
            "component_type": 1,
            "traffic_type": 0,
            "leads_count": 1000
        },
        {
            "component_type": 1,
            "traffic_type": 1,
            "leads_count": 1000
        },
        {
            "component_type": 2,
            "traffic_type": 0,
            "leads_count": 1000
        },
        {
            "component_type": 2,
            "traffic_type": 1,
            "leads_count": 1000
        }
    ]
}

# 错误码

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

# 枚举值

# source_type

来源类型

枚举值 描述
0 直播

# component_type

组件类型

枚举值 描述
0 表单
1 企微名片
2 企微客服

# traffic_type

流量来源

枚举值 描述
0 自然流量
1 广告流量