快手广告投放平台：建站工具模块API接口《NO.1》

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

view_comps

int[]

选填

包含的组件类型, 多个类型之间是或的关系

0: 图片

1: 文本

2: 表单

3: 按钮

4: 轮播图

5: 视频

6: 地图

7: 应用下载

page_name

string

选填

落地页名称

page_type

int

选填

落地页类型

1表示联盟，非1现在都是主站

page

int

选填

请求的页码

默认为1

page_size

int

选填

每页行数

默认为20，上限500

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

total_count

int

数据的总行数

id

long

落地页ID

name

string

落地页名称

comps

Comp

落地页包含的组件

具体介绍见下方

url

string

落地页URL

biz_type

int

落地页类型

0：站内

1：联盟

create_time

string

创建时间

格式：yyyy-MM-dd hh:MM:ss

update_time

string

修改时间

格式：yyyy-MM-dd hh:MM:ss

comps

字段

类型

说明

备注

id

long

组件id

type

int

组件类型

0: 图片

1: 文本

2: 表单

3: 按钮

4: 轮播图

5: 视频

6: 地图

7: 应用下载

name

string

组件名

props

object

组件属性

当type为7时, props存在属性appId, 其他类型没有这个属性

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/lp/page/list' \

--header 'access-token:xxxxxxxxxx' \

--header 'Content-Type: application/json' \

--data-raw '{

  "advertiser_id": 28751,

  "page_name": "落地页03-16",

  "status": 2,

  "page": 1,

  "page_size": 500

}'

返回样例

{

  "code": 0,

  "message": "OK",

  "data": {

      "total_count": 1,

      "details": [

          {

              "id": 10784442026240,

              "name": "落地页03-16 15:58",

              "url": "https://moli.kuaishou.com/rest/n/lp/page/getHtml?pageId=10784442026240",

              "create_time": "2020-03-16 15:59:04",

              "update_time": "2020-03-16 15:59:04",

              "comps": [

                  {

                      "props": {},

                      "id": 10784442026240,

                      "type": 0,

                      "name": "IMAGE"

                  }

              ]

          }

      ]

  }

}

请求参数

字段

类型

是否必填

说明

备注

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

struct

JSON返回值

total_count

int

数据的总行数

id

long

线索id

clue_stat

string

线索意向

0:未标记

1:无用

2:潜在客户

3:高潜客户

4:已成单

follow_stat

string

线索跟进状态

0:未标记

1:待跟进

2:跟进中

3:已跟进

call_stat

string

线索通话状态

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

字段

类型

说明

备注

page_id

long

落地页id

page_name

string

落地页名称

callback

string

callback串

form

字段

类型

说明

备注

id

long

表单id

name

string

表单名称

detail

字段

类型

说明

备注

key

string

表单项的label

value

string

收集的线索数据

compType

string

表单项类型

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/gemini/clue/list' \

--header 'access-token: ff0d56bbb879b9cc0fb673da0ed12f2b' \

--header 'Content-Type: application/json' \

--data-raw '{

 "advertiser_id": 28751,

 "pub_source_ids":["79713429816871168","79713429816871168"]

返回样例

{
   "code":0,
   "message":"OK",
   "data":{
       "total_count":1,
       "details":[
           {
               "id":102895296648317387,
               "clue_stat":1,
               "follow_stat":0,
               "call_stat":1,
               "remark":"11111",
               "clue_source":{
                   "page_id":102823496648458679,
                   "page_name":"落地页-成龙",
                   "callback":"adfafwef23ed83fn34452d"
               },
               "form_id":102895074874493387,
               "form":{
                   "id":102895074874493387,
                   "name":"表单06-19 17:56"
               },
               "details":[
                   {
                       "key":"姓名",
                       "value":"大鹅",
                       "compType":"姓名"
                   },
                   {
                       "key":"电话",
                       "value":"",
                       "compType":"电话"
                   },
                   {
                       "key":"say something",
                       "value":"铁锅",
                       "compType":"普通文本"
                   }
               ],
               "create_time":"2020-06-19 17:57:49",
               "update_time":"2020-06-30 17:14:06"
           }
       ]
   }
}