请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/creative/list
请求方式：GET/POST
数据格式：JSON
请求参数
| 字段 |
类型 |
是否必填 |
说明 |
备注 |
| advertiser_id |
long |
必填 |
广告主ID |
在获取access_token的时候返回 |
| campaign_id |
long |
可选 |
广告计划ID |
过滤筛选条件，若不传或传空则视为无限制条件 |
| unit_id |
long |
可选 |
广告组ID |
过滤筛选条件，若不传或传空则视为无限制条件 |
| creative_id |
long |
可选 |
广告创意ID |
过滤筛选条件，若不传或传空则视为无限制条件 |
| creative_name |
string |
可选 |
广告创意名称 |
过滤筛选条件，支持模糊搜索 精确查询 |
| creative_ids |
long[] |
可选 |
广告创意ID集 |
不超过 100 个 |
| status |
int |
可选 |
广告创意状态 |
过滤筛选条件；-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，22：不在投放时段。41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常 -2：所有包含已删除 40：只包含已删除不传：所有不包含已删除 其他值无效 |
| start_date |
string |
可选 |
开始时间 |
与end_date同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息 |
| end_date |
string |
可选 |
结束时间 |
与start_date同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息 |
| time_filter_type |
int |
可选 |
按创建时间或者更新时间进行筛选 |
1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为1时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为0时，则按照更新时间进行筛选 |
| page |
int |
可选 |
请求的页码数 |
默认为1 |
| page_size |
int |
可选 |
请求的每页行数 |
默认为20 |
| actionbar_click_url |
string |
可选 |
第三方点击按钮监测链接 |
|
返回参数
| 字段 |
类型 |
说明 |
备注 |
|
| code |
int |
返回码 |
|
在获取access_token的时候返回 |
| message |
string |
返回信息 |
|
过滤筛选条件，若不传或传空则视为无限制条件 |
| data |
struct |
JSON返回值 |
|
过滤筛选条件，若不传或传空则视为无限制条件 |
| details |
struct |
返回值详情 |
|
过滤筛选条件，若不传或传空则视为无限制条件 |
| campaign_id |
long |
广告计划ID |
|
过滤筛选条件，支持模糊搜索 精确查询 |
| unit_id |
long |
广告组ID |
|
不超过 100 个 |
| creative_id |
long |
广告创意ID |
|
过滤筛选条件；-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常 -2：所有包含已删除 40：只包含已删除 不传：所有不包含已删除其他值无效 |
| creative_name |
string |
广告创意名称 |
|
与end_date同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息 |
| creative_material_type |
int |
素材类型 |
0：历史创意未作区分 1：竖版视频2：横版视频3：后贴片单图图片创意（历史类型，已下线）4：便利贴单图图片创意 11：开屏视频 12：开屏图片 |
|
| photo_id |
string |
视频作品ID |
|
|
| material_url |
string[] |
单图创意url |
|
|
| image_tokens |
string[] |
单图创意image_token |
|
|
| status |
int |
广告创意状态（优先先看这个状态,计算结果） |
-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，40：已删除，41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常，54：视频审核通过可投放滑滑场景，55：部分素材审核失败 |
|
| put_status |
int |
投放状态（操作结果） |
1：投放中；2：暂停 3：删除 |
|
| create_channel |
int |
创建渠道 |
0：投放后台创建；1：Marketing API创建 |
|
| review_detail |
string |
审核拒绝理由 |
|
|
| reject_video_snapshot |
List<String> |
审核拒绝图片 |
list里面可以包含多个数据 |
|
| cover_url |
string |
封面URL |
|
|
| image_token |
string |
视频封面token |
若创意使用系统自动生成的首帧图片作为封面，该token无法复用 |
|
| first_frame_type |
int |
视频封面来源 |
1：首帧，0：非首帧 |
|
| cover_width |
long |
封面图宽度 |
|
|
| cover_height |
long |
封面图高度 |
|
|
| overlay_bg_url |
string |
动态词包原始封面图片URL |
|
|
| overlay_bg_image_token |
string |
动态词包原始封面图片token |
|
|
| sticker_title |
string |
封面广告语标题 |
|
|
| overlay_type |
string |
贴纸样式类型 |
|
|
| display_info |
struct |
广告展示信息 |
详情见下方 |
|
| short_slogan |
string |
便利贴创意短广告语 |
|
|
| expose_tag |
string |
广告标签 |
|
|
| new_expose_tag |
string[] |
广告标签2期 |
|
|
| site_id |
long |
安卓下载中间页ID |
|
|
| click_track_url |
string |
点击监测链接 |
若出现与后台显示不一致，以文档为准即可 |
|
| impression_url |
string |
第三方开始播放监测链接 |
若出现与后台显示不一致，以文档为准即可 |
|
| ad_photo_played_t3s_url |
string |
第三方有效播放监测链接 |
仅历史个别账户使用 |
|
| programmed_creative_material |
struct |
程序化创意物料 |
详见下方 |
|
| creativeStatusType |
int |
否为僵尸创意 |
1：僵尸 0：非僵尸 |
|
| total_count |
int |
数据总数 |
|
|
| create_time |
string |
创建时间 |
格式样例："2019-06-11 15:17:25" |
|
| update_time |
string |
最后修改时间 |
格式样例："2019-06-11 15:17:25" |
|
| splash_photo_ids |
string[] |
开屏视频id |
creative_material_type为11时 |
|
| splash_image_tokens |
string[] |
开屏图片token |
creative_material_type为12时 |
|
| display_info |
|
|
|
| 字段 |
类型 |
说明 |
备注 |
| description |
string |
广告语 |
|
| action_bar_text |
string |
行动号召按钮文案 |
|
| programmed_creative_material |
|
|
|
| 字段 |
类型 |
说明 |
备注 |
| materials |
struct[] |
物料信息 |
详见下方 |
| sticker_style_ids |
int[] |
封面贴纸类型ID |
|
| description_titles |
string[] |
广告语 |
|
| sticker_titles |
string[] |
封面广告语 |
|
| materials |
|
|
|
| 字段 |
类型 |
说明 |
备注 |
| photo_id |
string |
视频ID |
|
| image_tokens |
string[] |
封面图片token |
|
| creative_material_type |
int |
素材类型 |
|
| sticker_titles |
string[] |
封面广告语 |
|
请求样例
curl -X GET \
-H 'Access-Token: eaba7b0d52cea6ce39bf442f944a4e0c' \
-H 'Content-Type: application/json' \
-d '{
"advertiser_id": 49,
"page":1,
"page_size":1
}' -L https://ad.e.kuaishou.com/rest/openapi/v1/creative/list
评论列表