请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/list
请求方式：POST
数据格式：JSON
请求参数
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| advertiser_id | long | 必填 | 快手广告主ID | 在获取accessToken的时候返回 |
| photo_ids | string[] | 非必填 | 快手短视频 id列表， | 不超过 100 个 id |
| new_status | int | 非必填 | 快手短视频状态s | 0：删除， -1：全部数据，包含删除 不传默认返回不含删除的数据 |
| end_date | string | 可选 | 结束时间 | 与start_date同时传或同时不传； 过滤筛选条件，格式为"yyyy-MM-dd" |
| page | int | 可选 | 查询的页码数 | 默认为1 |
| page_size | int | 可选 | 单页行数 | 默认为20，不超过200 |
返回参数
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | int | 返回码 | |
| message | string | 返回信息 | |
| data | struct | JSON返回值 | |
| photo_id | string | 快手短视频ID | |
| width | int | 快手短视频宽度 | |
| height | int | 快手短视频高度 | |
| url | string | 快手短视频广告预览链接 | 快手短视频广告投放平台 |
| cover_url | string | 快手短视频首帧图片链接 | |
| signature | string | 快手短视频md5值 | |
| upload_time | string | 上传时间 | |
| photo_name | string | 快手短视频名称 | 默认是视频 id |
| photo_tag | string[] | 快手短视频标签 | |
| new_status | int | 快手短视频状态 | 0：视频库删除，1：可用状态，2：转码中，3：审核中，11：转码失败，12：审核失败，13：已屏蔽，14：视频在客户端删除 |
| duration | long | 快手短视频时长 | 单位毫秒 |
| source | int | 快手短视频来源 | 0：自上传，1：开眼，2：素造，7：聚星视频，8：LA 素材上传，10：个人主页 |
请求样例
curl -X GET \
-H 'Access-Token: 6acd879e43a39dfbd9e757e2082b58b5' \
-H 'Content-Type: application/json' \
-d '{
"advertiser_id": 200152}' -L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/video/list
返回样例
复制{ "code": 0, "message": "OK", "data": { "total_count": 44, "details": [
{ "width": 720, "height": 1280, "url": "http://hwmov.a.yximgs.com/upA5MjMxMDQ05MF8wXzM=_b_Be957badfd1d7fe45db3d066d4f67a1a8.mp4?tag=1-156920690d86659d5ca", "signature": "f9bdb92dee8dadc381c4fd7831089d0e", "photo_id": "5246693584821825030", "cover_url": "http://hw.a.yximgs.com/upiMV8xNzc2NzExNzY5MF8wXzM=_B9b9f47dc0c9e89a14142c6c8a0e90171.jpg?tag=1-15692064c46fbbc0fe"
},
{ "width": 720, "height": 1280, "url": "http://jsmov2.a.yximgs.com/upic/201BMjAxOTA5Maf5a45ed3fc3c1.mp4?tag=1-156923a3bf18c8", "signature": null, "photo_id": "5199124315305004489", "cover_url": "http://js2.a.yximgs.com/upic/20OTA59a4a03ed6f895b3f2e796bf.jpg?tag=1-15692060d09bd284"
}
]
}
}
评论列表