根据分类获取节目

1. 接口描述

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

2. 参数

参数名 参数类型 必选 默认值 参数描述 示例
client_id string true 应用Key
category string true 分类 电视剧
genre string false 类型 古装,言情
area string false 地区 大陆,香港
release_year int false 上映年 2010
paid int false 是否付费 0.免费 1.付费 0
orderby string false view-today-count 排序 view-count: 总播放数 comment-count: 总评论数 reference-count: 总引用数 favorite-count: 总收藏数 view-today-count: 今日播放数 view-week-count: 本周播放数 release-date: 上映日期 score: 评分 updated: 最后一个正片添加时间 updated
streamtypes string false 流格式 flvhd flv 3gphd 3gp hd hd2
person string false 人物姓名或ID 刘德华
page int false 1 页数 1
count int false 20 页大小 page*count必须小于等于1000 默认20,最大值100

3. 返回参数

3.1 total 符合条件的视频数量
参数名 参数全称 允许为空 说明 示例
total int false 符合条件的节目数量
3.2 show 节目
参数名 参数全称 允许为空 说明 示例
id string false 节目ID
name string false 节目名称
link string true 节目链接
play_link string true 节目首个正片播放链接
last_play_link string true 节目最新正片播放链接
poster string true 节目海报
thumbnail string true 节目图片
streamtypes string true 流格式 flvhd flv 3gphd 3gp hd hd2
episode_count int false 总集数
episode_updated int true 更新至
view_count int false 总播放数
score float false 评分
paid int false 是否付费 0.否 1.是
released string false 节目发行时间(YYYY-MM-DD)
published string false 优酷发行时间(YYYY-MM-DD)

4. 响应示例

{
       "total" : 100,
       "shows" :
       [
           {
               "id" : "2a7260de1faa11e097c0",
               "name" : "裸婚时代",
               "link" : "http://www.youku.com/show_page/id_z2a7260de1faa11e097c0.html",
               "play_link" : "http://v.youku.com/v_show/id_XMjc0MzM1OTgw.html",
               "poster" : "http://g4.ykimg.com/0100641F464E1FC...",
               "thumbnail" : "http://g4.ykimg.com/0100641F464E1FC...",
               "streamtypes" : ["hd2,flvhd,flv,hd,3gp,3gphd"],
               "episode_count" : 30,
               "episode_updated" : 30,
               "view_count" : "345037980",
               "score" : 9.3,
               "paid" : 0,
               "published" : "0000-00-00",
               "released" : "2011-06-11",
           },
           …
       ]
   }

5. 错误代码