根据分类获取视频

1. 接口描述

URL https://openapi.youku.com/v2/videos/by_category.json
功能描述 根据分类获取视频
返回格式 json
HTTP请求方式 GET
授权/登录 false
当前接口版本 V2
其他接口版本

2. 业务参数

参数名 参数类型 必选 默认值 参数描述 示例
client_id string true 应用Key
category string false 分类 资讯
genre string false 类型 社会资讯
period string false today 时间范围 today: 今日 week: 本周 month: 本月 history: 历史 today
orderby string false view-count 排序 published: 发布时间 view-count: 总播放数 comment-count: 总评论数 reference-count: 总引用 favorite-time: 收藏时间 favorite-count: 总收藏数 published
page int false 1 页数 1
count int false 20 页面大小 20

3. 返回参数

3.1 video 视频
参数名 参数类型 允许为空 参数描述 示例
id String false 视频唯一ID
title string false 视频标题
link String false 视频播放链接
thumbnail string false 视频截图
duration int false 视频时长,单位:秒
category string false 视频分类
state String false 视频状态 normal: 正常 encoding: 转码中 fail: 转码失败 in_review: 审核中 blocked: 已屏蔽
view_count int false 总播放数
favorite_count int false 总收藏数
comment_count int false 总评论数
up_count int false 总顶数
down_count int false 总踩数
published String false 发布时间
user object false 上传用户对象
operation_limit array true 操作限制 COMMENT_DISABLED: 禁评论 DOWNLOAD_DISABLED: 禁下载
streamtypes array true 视频格式 flvhd flv 3gphd 3gp hd hd2
favorite_time string false 收藏时间
3.2 user 上传用户
参数名 参数类型 允许为空 参数描述 示例
id string false 用户ID
name string false 用户名
link string false 用户个人空间地址

4. 响应示例

{
    "total" : 100,
    "page" : 1,
    "count" : 20,
       "videos" :
       [
           {
               "id" : "XMjg1MTcyNDQ0",
               "title" : "泡芙小姐的灯泡 11",
               "link" : "http://v.youku.com/v_show/id_XMjg1MTcyNDQ0.html",
               "thumbnail" : "http://g4.ykimg.com/0100641F464E1FC...",
               "duration" : "910",
               "category" : "原创",
               "state" : "normal",
               "view_count" : 2555843,
               "favorite_count" : 534,
               "comment_count" : 1000,
               "up_count" : 14859,
               "down_count" : 559,
               "published" : "2011-07-15 09:00:42",
               "user" :
               {
                   "id" : 58921428,
                   "name" : "泡芙小姐",
                   "link" : "http://u.youku.com/user_show/id_UMjM1Njg1NzEy.html"
               },
               "operation_limit": ["COMMENT_DISABLED"],
               "streamtypes" : ["flv","flvhd","hd"],
               "favorite_time" : "2012-01-01 09:00:00"
           }
           …
       ]
}


        	 

5. 错误代码