1. 广告创意
磁力引擎
  • M-API 注册认证问题Q&A
  • M-API咨询类问题Q&A
  • 快速入门
    • 如何开通快手mapi
  • Oauth2.0授权
    • 授权流程
    • scope 权限说明
    • token管理
      • token有效期&续期
      • 获取 token
      • 刷新 token
  • 账户服务
    • 广告主
      • 获取广告账户信息
      • 获取广告账户余额信息
      • 获取广告账户流水信息
    • 账户罗盘
      • 获取罗盘绑定广告主列
      • 磁力罗盘对外 quota 腾挪接口
    • 代理商
      • 上传资质文件
      • 获取账号信息和开户资质
      • 创建或更新账户信息和开户资质
      • 创建或更新投放资质
      • 可复制账户列表
      • 复制账户
  • 广告投放
    • 账户层级
      • 账户日预算查询
      • 修改账户预算
      • 账户操作记录信息查询
    • 创编2.0(已下线)
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划预算
      • 广告组
        • 创建广告组
        • 创建联盟定投广告组
        • 创建搜索广告组
        • 创建搜索快投广告组
        • 修改广告组
        • 修改联盟定投广告组
        • 修改搜索广告组
        • 修改搜索快投广告组
        • 定向人群预估查询
        • 获取广告组信息
      • 广告创意
        • 创建创意
          POST
        • 创建程序化 2.0 创意
          POST
        • 批量创建&修改创意
          POST
        • 修改创意
          POST
        • 修改程序化 2.0 创意
          POST
        • 获取广告创意信息
          GET
        • 获取程序化创意 2.0 信息
          POST
    • 创编3.0(已下线)
      • 广告创建接口
      • 广告创建接口(广告组和广告创意)
      • 广告计划更新接口
      • 广告组更新接口
      • 广告创意更新接口(程序化创意和自定义创意)
      • 广告详情接口
      • 广告计划详情接口
      • 广告组详情接口
      • 广告创意详情接口
    • 智能化创编
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划状态
      • 广告组
        • 创建广告组
        • 修改广告组
        • 查询广告组
        • 修改广告组预算
        • 修改广告组状态
        • 修改广告组出价
      • 广告创意
        • 创建自定义创意
        • 创建程序化创意
        • 修改自定义创意
        • 修改程序化创意
        • 批量修改自定义创意
        • 查询自定义创意
        • 查询程序化创意
        • 修改创意状态
        • 创意体验
        • 创意标签填写建议
        • 获取程序化创意 2.0 审核信息
      • 批量获取监测链接接口
      • 监测链接批量更新接口
    • 高级创意
      • 获取高级创意列表
      • 创建高级创意接口
      • 删除高级创意接口
    • 搜索广告投放工具
      • 关键词管理
        • 获取关键词列表
        • 创建关键词
        • 修改关键词匹配方式
        • 修改关键词投放状态
        • 批量导出关键词
        • 获取关键词导出文件
      • 否定词管理
        • 获取否定词列表
        • 更新否定词
  • 数据报表
    • 异步任务数据报表
      • 创建历史数据查询任务
      • 获取任务状态
      • 数据下载
    • 直播报表
      • 报表新增直播数据
      • 直播间组件报表
      • 直播间报表
    • 获取原生效果数据整体概览接口(数据概览、分日转化数据分布、转化漏斗)
    • 原生效果数据报表明细接口
    • 查询原生快手号列表(for原生报表)
    • 代理商数据(t-1 数据需要第二天 9 点以后获取)
    • 广告主数据(实时)
    • 广告计划数据(实时)
    • 广告组数据
    • 广告创意数据-自定义
    • 程序化创意 2.0 数据
    • 素材报表
    • 人群分析报表
    • 小店通转化数据报表
    • 程序化落地页报表
    • 获取商品库报表
    • 关键词报表
    • 搜索词报表
    • 探索工具关键报表数据
  • 素材管理
    • 图片素材
      • 上传图片 v1 接口【逐步废弃,请使用V2接口】
      • 上传图片 v2 接口
      • 查询图片信息 get 接口
      • 查询图片接口 list 接口
      • 图片库推送
      • 获取可选的封面贴纸样式
    • 视频素材
      • 上传视频接口 v1【逐步废弃,请使用V2接口】
      • 上传视频接口 v2
      • 获取视频信息 get 接口(可通过 photo_ids 查询所有视频)
      • 获取视频信息 list 接口推荐使用,仅能查询平台&MAPI 上传,可查 uid 下所有非素造视频)
      • 批量删除视频
      • 上传图文视频
    • 视频库
      • 视频库-推送视频
      • 视频库-推送视频(新版)
      • 视频库-批量更新视频功能
      • 视频库-删除视频标签
      • 视频关联创意数查询
    • 文件上传
      • 图文音频文件MAPI上传
  • 素造平台
    • 获取素造视频接口
  • 建站管理
    • 魔力建站落地页信息查询接口
    • 魔力建站落地页批量创建接口
    • 魔力建站落地页更新CID信息
    • 魔力建站营销组件-表单查询接口
    • 魔力建站预约下载信息查询接口
    • 魔力建站落地页组信息查询接口
    • 魔力建站落地页组创建接口
    • 魔力建站落地页组更新接口
    • 魔力建站落地页组删除接口
    • 魔力建站落地页投放开关接口
  • 线索管理-老铁线索通
    • 线索通-批量创建微信小游戏
    • 线索通-获取微信小游戏列表
    • 线索 crm 信息查询接口
    • 线索 crm 意向度/进度/通话状态更新接口
    • 发起外呼接口
    • 获取通话记录
    • 线索crm赔付线索回传接口
  • DMP人群管理
    • 文件上传接口(新)
    • 人群包创建接口(新)
    • 人群包更新接口(新)
    • 人群列表查询接口
    • 人群包删除接口
    • 人群包跨账户推送
    • 人群包上线接口
    • 系统推荐定向/排除人群包
  • 联合建模
    • 样本文件上传
    • 通过上传方式新建样本
  • 工具
    • 短句
      • 通过快手号id查询授权短剧接口
      • 通过短剧id查询剧集列表
      • 获取授权的短剧作者列表
    • 查询工具
      • 创意相关
        • 获取创意推荐理由
      • 获取可选的深度优化目标
      • 获取可选的浅度优化目标
      • 获取可选的定向标签
      • 获取可选的应用定向
      • 获取可选的推荐封面
      • 获取可选的动态词包
      • 获取行动号召按钮
      • 获取可选的封面贴纸样式
      • 获取可用的转化目标
      • 获取可选白名单接口
      • 获取地域定向
      • 获取商圈地域定向
      • 获取可用咨询组件列表
      • MAPI Quota 白盒化
      • 获取创意分类查询接口
      • 快手网红-网红分类
      • 种子人群包列表
      • 快手网红-搜索快手网红
    • 功能名单
      • 获取创意分类标签白名单客户
      • 获取联盟投放白名单
    • 评论管理
      • 评论列表数据查询
      • 回复评论
      • 评论树查询
      • 屏蔽评论
      • 增加屏蔽评论信息
      • 删除屏蔽评论信息
      • 获取屏蔽评论信息列表
      • 评论管理-评论置顶
      • 评论管理-取消评论置顶
    • 应用列表
      • 获取应用列表
      • 应用权限信息列表接口
    • 行为兴趣标签-创意层级
      • 获取行为与兴趣"类目"
      • 获取行为兴趣"关键词"
    • 定向模板(新)
      • 创建定向模板
      • 更新定向模板
      • 查询定向模板
      • 删除定向模板
      • 定向模板同步
      • 模板同步失败查询
      • 查询模板关联的广告列表接口
      • 查询待升级模板列表
      • 模板升级
    • 小说库
      • 获取小说列表
      • 获取小说详情
      • 获取小说各分类枚举
      • 创建小说
      • 小说批量更新
      • 小说批量删除
      • 批量下载小说图片接口
      • 小说报表
      • 小说批量分享
    • 联盟自定义媒体包
      • 联盟定向媒体包创建
      • 联盟定向媒体包修改
      • 联盟定向媒体包删除
      • 获取联盟定向媒体包列表
      • 联盟定向媒体包广告位报表
    • 游戏试玩
      • 上传试玩素材
      • 直存试玩
      • 获取试玩按钮列表
      • 获取试玩列表
      • 试玩推送
      • 查看共享账户
    • 商品库
      • 商品库各行业商品数据校验规则
      • 查询 DPA 模板信息
      • 获取商品库列表
      • 获取商品库类目树
      • 创建商品
      • 更新商品
      • 获取商品列表
      • 获取商品列表(部分信息)
      • 获取商品列表(游标)
      • 获取SDPA创意视频模板
      • 批量模板合成SDPA创意视频
    • 出价建议
      • 批量获取广告组出价建议
      • 获取广告组曝光、转化预估
      • 获取广告组投放预估曲线
    • 直播推广
      • 获取主播列表
      • 获取直播间小铃铛列表
    • 探索工具
      • 一键复苏开启
      • 一键复苏关闭
      • 加速探索-开启接口
      • 加速探索关闭
      • 辅助探索开启
      • 探索工具状态查询
      • 探索工具报表
      • 探索工具使用记录
      • 探索工具关键报表数据
    • 智能托管
      • 枚举说明
      • 智能托管创建及更新接口
      • 智能托管状态更新
      • 智能托管删除接口
      • 获取智能托管详情接口
      • 获取智能托管物料接口
      • 智能托管报表接口
      • 分小说展开效果数据接口
    • 投前预估
      • 创建投前预估任务
      • 投前预估详情
      • 投前预估列表
      • 投前预估任务管理
    • 原生广告投放工具
      • 隐藏视频同步至个人主页
      • 获取快手号授权列表
      • 快手号授权接口
      • 获取达人原生视频列表接口
      • 共享授权接口
      • 共享授权结果
      • 共享授权-获取已共享授权授权记录
      • 获取原生快手号列表接口
      • 本地视频上传接口
  • 频控和创建限制
    • 频控和创建限制
    • 接口调用分级使用
  • 磁力聚星
    • 投后数据
      • 星视频--查询订单的投后数据
      • 星任务(视频)-查询任务的投后数据
      • 星任务(视频)-查询订单的投后数据
  • 转化归因
    • 转化归因信息合辑
      • 转化归因信息合辑
  • 应用管理
    • 接入前言
    • 文件上传【必选】
      • 【应用中心】上传 APK 文件
      • 【应用中心】上传图片
    • 应用创编【必选】
      • 【应用中心】创建 Android 应用
      • 【应用中心】创建 iOS 应用
      • 【应用中心】编辑 Android 应用
      • 【应用中心】更新 iOS 应用
    • 应用查询For单元投放【必选】
      • 获取新版应用发布列表【单元创编】
      • 获取新版分包发布列表【单元创编】
    • 应用查询For应用中心【可选】
      • 【应用中心】获取应用列表
      • 【应用中心】获取应用详情
    • 应用共享【可选】
      • 【应用中心】添加应用共享
      • 【应用中心】取消应用共享
      • 【应用中心】获取应用已共享账号列表
      • 【应用中心】获取应用已共享主体列表
      • 【应用中心】获取单个主体下共享账号列表
      • 【应用中心】获取可共享的主体列表
      • 【应用中心】获取可共享的账号列表
    • 应用操作【可选】
      • 【应用中心】iOS 应用上报更新
      • 【应用中心】发布应用
      • 【应用中心】应用上架
      • 【应用中心】应用下架
      • 【应用中心】应用商店上下架
    • 应用分包【可选】
      • 【应用中心】新建应用分包
      • 【应用中心】更新/恢复/删除应用分包
      • 【应用中心】修改应用分包备注
      • 【应用中心】获取分包管理/回收站列表
      • 【应用中心】分包失败,重新构建
    • 其他接口【可选】
      • 【应用中心】获取应用尚未发布的最新的应用包信息
      • 【应用中心】获取应用版本记录
      • 获取新版应用发布详情
      • 人群包数据
  • 附录
    • 3.0创编接口改动
    • 报错 code 枚举值
  1. 广告创意

获取广告创意信息

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
GET
https://ad.e.kuaishou.com/rest/openapi/v1/creative/list

返回参数

字段类型说明备注
codeint返回码在获取 access_token 的时候返回
messagestring返回信息过滤筛选条件,若不传或传空则视为无限制条件
datastructJSON 返回值过滤筛选条件,若不传或传空则视为无限制条件
detailsstruct返回值详情过滤筛选条件,若不传或传空则视为无限制条件
campaign_idlong广告计划 ID过滤筛选条件,支持模糊搜索 精确查询
unit_idlong广告组 ID不超过 100 个
creative_idlong广告创意 ID过滤筛选条件;-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,11:组审核中,12:组审核未通过,14:已结束,15:组已暂停,17:组超预算,19:未达投放时间,41:审核中,42:审核未通过,46:已暂停,52:投放中,53:作品异常 -2:所有包含已删除 40:只包含已删除 不传:所有不包含已删除其他值无效
creative_namestring广告创意名称与 end_date 同时传或同时不传;过滤筛选条件,格式为"yyyy-MM-dd",参数值对应 update_time 信息
creative_material_typeint素材类型0:历史创意未作区分 1:竖版视频 2:横版视频 3:后贴片单图图片创意(历史类型,已下线)4:便利贴单图图片创意 11:开屏视频 12:开屏图片
photo_idstring视频作品 ID
material_urlstring[]单图创意 url
image_tokensstring[]单图创意 image_token
statusint广告创意状态(优先先看这个状态,计算结果)-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,11:组审核中,12:组审核未通过,14:已结束,15:组已暂停,17:组超预算,19:未达投放时间,40:已删除,41:审核中,42:审核未通过,46:已暂停,52:投放中,53:作品异常,54:视频审核通过可投放滑滑场景,55:部分素材审核失败
put_statusint投放状态(操作结果)1:投放中;2:暂停 3:删除
create_channelint创建渠道0:投放后台创建;1:Marketing API 创建
review_detailstring审核拒绝理由
reject_video_snapshotList审核拒绝图片list 里面可以包含多个数据
cover_urlstring封面 URL
image_tokenstring视频封面 token若创意使用系统自动生成的首帧图片作为封面,该 token 无法复用
dpa_template_idlong可选DPA模板ID通过DPA 模板查询接口获取
first_frame_typeint视频封面来源1:首帧,0:非首帧
cover_widthlong封面图宽度
cover_heightlong封面图高度
overlay_bg_urlstring动态词包原始封面图片 URL
overlay_bg_image_tokenstring动态词包原始封面图片 token
sticker_titlestring封面广告语标题
overlay_typestring贴纸样式类型
display_infostruct广告展示信息详情见下方
short_sloganstring便利贴创意短广告语
expose_tagstring广告标签
new_expose_tagstring[]广告标签 2 期广告标签
site_idlong安卓下载中间页 ID
click_track_urlstring点击监测链接若出现与后台显示不一致,以文档为准即可
impression_urlstring第三方开始播放监测链接若出现与后台显示不一致,以文档为准即可
ad_photo_played_t3s_urlstring第三方有效播放监测链接仅历史个别账户使用
programmed_creative_materialstruct程序化创意物料详见下方
total_countint数据总数
create_timestring创建时间格式样例:"2019-06-11 15:17:25"
update_timestring最后修改时间格式样例:"2019-06-11 15:17:25"
pic_idstring图片库图片
app_grade_typeint审核分级类型0:默认;1:审核降级(当创意发生降级时,会限制部分流量无法投放)
splash_photo_idsstruct[]开屏视频 idcreative_material_type 为 11 时
live_creative_typeint粉丝直播推广创意类型3:直投直播;4:作品引流
splash_picturesstruct[]开屏图片creative_material_type 为 12 时
live_track_urlstring点击监测链接计划 campaignType=16 粉丝直播推广时填写
ad_typeint广告计划类型0:信息流,1:搜索
outer_loop_nativeint选填是否开启原生0关闭,1开启,不填默认为0
kol_user_typeint选填原生达人用户类型2服务号原生,3聚星达人原生, 不开启原生时此项为0
dpa_style_typesint[]动态商品卡样式14001-区域服务卡

display_info
字段类型说明备注
descriptionstring广告语
action_bar_textstring行动号召按钮文案

programmed_creative_material
字段类型说明备注
materialsstruct[]物料信息详见下方
sticker_style_idsint[]封面贴纸类型 ID
description_titlesstring[]广告语
sticker_titlesstring[]封面广告语

materials
字段类型说明备注
photo_idstring视频 ID
image_tokensstring[]封面图片 token
creative_material_typeint素材类型
sticker_titlesstring[]封面广告语

new_expose_tag
字段类型说明备注
textstring广告语

splash_pictures
字段类型说明备注
cover_idlong封面ID
cover_urlstring封面URL
heightlong图片高度
widthlong图片宽度

splash_photos
字段类型说明备注
photo_idstring视频ID
cover_urllong视频高度
heightlong视频宽度

请求参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ad.e.kuaishou.com/rest/openapi/v1/creative/list' \
--header 'Content-Type: application/json' \
--data '{
   "advertiser_id": 49,
   "page":1,
   "page_size":1
}'
响应示例响应示例
{}
修改于 2023-10-23 08:44:52
上一页
修改程序化 2.0 创意
下一页
获取程序化创意 2.0 信息
Built with