请求接口： https://ad.e.kuaishou.com/rest/openapi/v2/gemini/clue/list
请求方式：POST
数据格式：JSON
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
备注 |
| advertiser_id |
long |
必填 |
快手广告主ID |
在获取access_token的时候返回 |
| form_ids |
long[] |
选填 |
组件id列表 |
支持多组件线索查询 |
| pub_source_ids |
long[] |
选填 |
发布资源id |
支持多发布资源线索查询 |
|
|
|
(建站为落地页id)列表 |
|
| start_time |
string |
选填 |
起始时间 |
格式：yyyy-MM-dd hh:MM:ss |
| end_time |
string |
选填 |
结束时间 |
格式：yyyy-MM-dd hh:MM:ss |
| user_name |
string |
选填 |
线索提交者姓名 |
过滤筛选条件，支持模糊搜索 |
| phone |
string |
选填 |
线索提交者手机号 |
|
| page |
int |
选填 |
请求的页码 |
默认为1 |
| page_size |
int |
选填 |
每页行数 |
默认为20，上限500 |
返回参数
| 字段 |
类型 |
说明 |
备注 |
| code |
int |
返回码 |
|
| message |
string |
返回信息 |
|
| data |
JSON |
|
|
| total_count |
int |
数据的总行数 |
|
| details |
JSON |
数据明细信息 |
|
| id |
long |
线索id |
|
| clue_stat |
int |
线索意向 |
0:未标记 1:无用 2:潜在客户 3:高潜客户 4:已成单 8.未接通-空号 9.未接通-停机 10.未接通-拒接 11.未接通-无应答 |
| follow_stat |
int |
线索跟进状态 |
0:未标记 1:待跟进 2:跟进中 3:已跟进 |
| call_stat |
int |
线索通话状态 |
0:未标记 1:待接通 2:未接通 3:已接通 101：已接通-有效通话 102：已接通-无效通话 103：未接通-拒接 104：未接通-无人接听 105：未接通-忙线 106：未接通-空号 107：未接通-停机 108：未接通 109：未接通-关机 201：已接通-有效通话 （系统判定） 202：已接通-无效通话 （系统判定） 203：未接通-拒接 （系统判定） 204：未接通-无人接听 （系统判定） 205：未接通-忙线 （系统判定） 206：未接通-忙线 （系统判定） 207：/未接通-停机 （系统判定） 208：未接通 （系统判定） 209：未接通-关机 （系统判定） |
| remark |
string |
备注信息 |
|
| form_id |
long |
所属表单id |
|
| create_time |
string |
创建时间 |
格式：yyyy-MM-dd hh:MM:ss |
| update_time |
string |
修改时间 |
格式：yyyy-MM-dd hh:MM:ss |
| clue_source |
JSON |
线索来源信息 |
|
| form |
JSON |
所属表单信息 |
|
| details |
JSON |
线索记录详情信息 |
|
| clue_source |
|
|
| 字段 |
类型 |
说明 |
| page_id |
long |
落地页id |
| page_name |
string |
落地页名称 |
| callback |
string |
callback串 |
| dsp_campaign_id |
long |
快手广告计划id |
| dsp_unit_id |
long |
快手广告组id |
| dsp_creative_id |
long |
快手广告创意id |
| form |
|
|
| 字段 |
类型 |
说明 |
| id |
long |
表单id |
| name |
string |
表单名称 |
| detail |
|
|
| 字段 |
类型 |
说明 |
| key |
string |
表单项的label |
| value |
string |
收集的线索数据 |
| compType |
string |
表单项类型 |
| custom_id |
string |
选项包中用户自定义索引字段 |
请求样例
curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/clue/list' \--header 'access-token: 2001269897942cf166354de6d5c444b6' \--header 'Content-Type: application/json' \--data-raw '{ "start_time": "2020-08-12 14:36:11", "end_time": "2020-08-13 14:39:00", "advertiser_id": 20006545
}
返回样例
复制
{ "code": 0, "data": { "total_count": 6, "details": [
{ "update_time": "2020-12-16 11:27:47", "clue_stat": 11, "call_stat": 2, "form": { "name": "王测试投放表单08-11 12:51", "id": 122024863348032450
}, "create_time": "2020-08-12 18:13:13", "follow_stat": 3, "form_id": 122024863348032450, "remark": "11111", "details": [
{ "comp_type": "姓名", "value": "王投放15", "key": "姓名"
},
{ "comp_type": "电话", "value": "15584418917", "key": "电话"
}
], "id": 122468119936500670, "clue_source": { "page_id": 122025028473585660, "dsp_campaign_id": 14984967, "dsp_creative_id": 471084335, "page_name": "测试落地页名称_1", "dsp_unit_id": 42383689, "callback": "BnCRjGqLZYHC-siNdrtfsb5pQCtCtrnj7-6VE1HhUr8Emmitw9U6jiX_T_TOpg1Jcl56m9WFB0NvmkV2zqAe1L4D74FO5QWQjU3nw3pOM0E_bVwklGfUE2SyaiSPN0z65odU3s34BIVdIE93Yp375jsNUpUrcuWmYKzDMp5L7Ez51ZP8JvSGnUw2q0H7iYHx"
}
}
]
}, "message": "OK"}
