查询视频

更新时间：2024-12-23 11:04:20

查询用户视频列表

scope : user_video_info

接口

GET	https://open.kuaishou.com/openapi/photo/list

请求参数

Url Query

参数	类型	含义	必填
access_token	string	oauth 令牌	是
app_id	string	快手注册的app_id	是
cursor	string	游标，用于分页，值为作品id。分页查询时，传上一页create_time最小的photo_id。第一页不传此参数。	否
count	int	数量，默认为20,最大不超过200	否

响应结果示例

{  
    result: 1,  
    video_list: [{  
        photo_id:xxx,  
        caption:xxx,  
        cover:xxx,  
        play_url:xxx,  
        create_time:xxx,  
        like_count:xxx,  
        comment_count:xxx,  
        view_count:xxx,  
        pending:xxx  
    }]  
}  

响应结果字段解析

字段	字段说明
result	状态码，1表示成功
video_list	作品列表
photo_id	作品id
caption	作品标题
cover	作品封面
play_url	作品播放链接
create_time	作品创建时间
like_count	作品点赞数
comment_count	作品评论数
view_count	作品观看数
pending	作品状态(是否还在处理中，不能观看)

查询单一视频详情

scope : user_video_info

接口

GET	https://open.kuaishou.com/openapi/photo/info

请求参数

Url Query

参数	类型	含义	必填
access_token	string	oauth 令牌	是
app_id	string	快手注册的app_id	是
photo_id	string	作品id	是

响应结果示例

{  
  "result": 1,  
  "video_info": {  
    "photo_id": "3xwn3kkerxj6g9n",  
    "caption": "测试标题",  
    "cover": "https://xxx",  
    "play_url": "https://xxx",  
    "create_time": 1596629598574,  
    "like_count": 1,  
    "comment_count": 1,  
    "view_count": 1,  
    "pending": false  
  }  
}  

响应结果字段解析

字段	字段说明
result	状态码，1表示成功
video_info	作品详情
photo_id	作品id
caption	作品标题
cover	作品封面
play_url	作品播放链接
create_time	作品创建时间
like_count	作品点赞数
comment_count	作品评论数
view_count	作品观看数
pending	作品状态(是否还在处理中，不能观看)

状态含义

状态	含义
120001	视频不存在
120002	视频未上传
120003	视频发布失败
100400	异常参数

查询视频数量接口

scope : user_video_info

接口

GET	https://open.kuaishou.com/openapi/photo/count

请求参数

Url Query

参数	类型	含义	必填
access_token	string	oauth 令牌	是
app_id	string	快手注册的app_id	是

响应结果示例

{  
  "result": 1,  
  "public_count": 1,  
  "friend_count": 1,  
  "private_count": 1,  
  "all_count": 1   
}  

响应结果字段解析

字段	字段说明
result	状态码，1表示成功
public_count	公开视频数量
friend_count	仅好友可见视频数量
private_count	尽自己可见视频数量
all_count	视频总量