1. 投前预估
磁力引擎
  • M-API 注册认证问题Q&A
  • M-API咨询类问题Q&A
  • 快速入门
    • 如何开通快手mapi
  • Oauth2.0授权
    • 授权流程
    • scope 权限说明
    • token管理
      • token有效期&续期
      • 获取 token
      • 刷新 token
  • 账户服务
    • 广告主
      • 获取广告账户信息
      • 获取广告账户余额信息
      • 获取广告账户流水信息
    • 账户罗盘
      • 获取罗盘绑定广告主列
      • 磁力罗盘对外 quota 腾挪接口
    • 代理商
      • 上传资质文件
      • 获取账号信息和开户资质
      • 创建或更新账户信息和开户资质
      • 创建或更新投放资质
      • 可复制账户列表
      • 复制账户
  • 广告投放
    • 账户层级
      • 账户日预算查询
      • 修改账户预算
      • 账户操作记录信息查询
    • 创编2.0(已下线)
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划预算
      • 广告组
        • 创建广告组
        • 创建联盟定投广告组
        • 创建搜索广告组
        • 创建搜索快投广告组
        • 修改广告组
        • 修改联盟定投广告组
        • 修改搜索广告组
        • 修改搜索快投广告组
        • 定向人群预估查询
        • 获取广告组信息
      • 广告创意
        • 创建创意
        • 创建程序化 2.0 创意
        • 批量创建&修改创意
        • 修改创意
        • 修改程序化 2.0 创意
        • 获取广告创意信息
        • 获取程序化创意 2.0 信息
    • 创编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创意视频
    • 出价建议
      • 批量获取广告组出价建议
      • 获取广告组曝光、转化预估
      • 获取广告组投放预估曲线
    • 直播推广
      • 获取主播列表
      • 获取直播间小铃铛列表
    • 探索工具
      • 一键复苏开启
      • 一键复苏关闭
      • 加速探索-开启接口
      • 加速探索关闭
      • 辅助探索开启
      • 探索工具状态查询
      • 探索工具报表
      • 探索工具使用记录
      • 探索工具关键报表数据
    • 智能托管
      • 枚举说明
      • 智能托管创建及更新接口
      • 智能托管状态更新
      • 智能托管删除接口
      • 获取智能托管详情接口
      • 获取智能托管物料接口
      • 智能托管报表接口
      • 分小说展开效果数据接口
    • 投前预估
      • 创建投前预估任务
        POST
      • 投前预估详情
        POST
      • 投前预估列表
        POST
      • 投前预估任务管理
        POST
    • 原生广告投放工具
      • 隐藏视频同步至个人主页
      • 获取快手号授权列表
      • 快手号授权接口
      • 获取达人原生视频列表接口
      • 共享授权接口
      • 共享授权结果
      • 共享授权-获取已共享授权授权记录
      • 获取原生快手号列表接口
      • 本地视频上传接口
  • 频控和创建限制
    • 频控和创建限制
    • 接口调用分级使用
  • 磁力聚星
    • 投后数据
      • 星视频--查询订单的投后数据
      • 星任务(视频)-查询任务的投后数据
      • 星任务(视频)-查询订单的投后数据
  • 转化归因
    • 转化归因信息合辑
      • 转化归因信息合辑
  • 应用管理
    • 接入前言
    • 文件上传【必选】
      • 【应用中心】上传 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
POST
https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/pre_put/predication_task/list

请求参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/pre_put/predication_task/list' \
--header 'Content-Type: application/json' \
--data '{
    "advertiser_id": 123,
    "page": {
        "current_page": 1,
        "page_size": 20
    }
}'
响应示例响应示例
{
    "code": 0,
    "data": {
        "page": {
            "total_count": 3,
            "current_page": 1,
            "page_size": 20
        },
        "tasks": [
            {
                "photo_pushed_status": 0,
                "predication_id": 55101688,
                "content_quality": 1,
                "title": "5s-3.mp4",
                "duration": 5000,
                "photo_predication_status": 2,
                "photo_url": "https://alimov2.a.kwimgs.com/upic/2021/12/07/17/BMjAyMTEyMDcxNzQ2MjdfMjE4NjY2NTM4M182MjI5MTQ1MDEwN18wXzM=_b_B5596f2337c208966b88f949cba05e6a8.mp4?tag=1-1644386914-unknown-0-rfclt1wkjx-336b12d5adcfa974&clientCacheKey=3x9gg2uwk9jge5c_b.mp4&tt=b&di=247090c5&bp=10000",
                "predication_time": 1642064018370,
                "ocpx_action_type": 180,
                "content_duplicate":false,
                "photo_id": 795194857901
            },
            {
                "photo_pushed_status": 1,
                "predication_id": 55101741,
                "content_quality": 1,
                "title": "5s-2.mp4",
                "duration": 5000,
                "photo_predication_status": 2,
                "photo_url": "https://alimov2.a.kwimgs.com/upic/2021/12/06/14/BMjAyMTEyMDYxNDE1MTFfMjE4NjY2NTM4M182MjIxNzUwODQ1NF8wXzM=_b_B6980bb0be0fe4603352fe27864879197.mp4?tag=1-1644386914-unknown-0-leii20f7jq-ad0e334ba1706547&clientCacheKey=3xtsdngb5bnrs8w_b.mp4&tt=b&di=247090c5&bp=10000",
                "predication_time": 1642064008952,
                "ocpx_action_type": 180,
                "content_duplicate":false,
                "photo_id": 89056723894
            },
            {
                "photo_pushed_status": 0,
                "predication_id": 60177601,
                "content_quality": 4,
                "title": "测试2.mp4",
                "duration": 21146,
                "photo_predication_status": 2,
                "photo_url": "https://alimov2.a.kwimgs.com/upic/2022/01/13/14/BMjAyMjAxMTMxNDA0MTdfMjE4NjY2NTM4M182NDc4MzE2OTA3N18wXzM=_b_B65255069a839ebc6b06bbec98e80b595.mp4?tag=1-1644386914-unknown-0-2np1gioypl-56089dc16f2a5360&clientCacheKey=3xsam4p48sc87zc_b.mp4&tt=b&di=247090c5&bp=10000",
                "predication_time": 1642063956483,
                "ocpx_action_type": 53,
                "content_duplicate":false,
                "photo_id": 487129
            }
        ]
    },
    "message": "OK",
    "request_id": "07817025287b4f24a2f13366fb558d64"
}
修改于 2023-10-25 06:22:11
上一页
投前预估详情
下一页
投前预估任务管理
Built with