搜库影视排行(全网)

1. 接口描述

URL https://openapi.youku.com/v2/searches/show/top_unite.json
功能描述 搜库影视大全排行(全网)
返回格式 Json,UTF8
HTTP请求方式 GET
授权/登录 false
当前接口版本 V2
其他接口版本

2. 业务参数

参数名 参数类型 必选 默认值 参数描述 示例
client_id string true 应用Key
category string true 分类 电视剧
genre string false 类型(电视剧,动漫,电影,综艺支持)/td> 1007
area string false 地区(电视剧,动漫,电影,综艺支持) 1001
year int false 上映年(电视剧,电影,综艺支持)/td> 2010
orderby string false 排序(电影,动漫支持) 1
headnum string true 每个节目要显示的前headnum集, 大于等于0(电视剧,动漫,综艺支持) 1
tailnum string true 每个节目要显示的前headnum集, 大于等于0(电视剧,动漫,综艺支持) 1
onesiteflag int false 0 默认站点标志 1:只返回一个默认的站点; 0:正常返回全部站点 0
page int false 1 页数 1
count int false 20 页大小 20
分类参数:genre
电视剧
参数值 说明
0 全部
1007 古装
1009 警匪
1010 搞笑
1011 悬疑
1012 神话
1001 偶像
1005 历史
1002 言情
1013 家庭
1014 科幻
1111 其他
电影
参数值 说明
0 全部
2001 喜剧
2003 爱情
2004 恐怖
2002 动作
2007 科幻
2008 战争
2012 警匪
2005 犯罪
2009 动画
2013 奇幻
2111 其他
动漫
参数值 说明
0 全部
5011 搞笑
5007 恋爱
5002 热血
5006 格斗
5010 美少女
5012 魔法
5013 机战
5005 校园
5014 少儿
5015 冒险
5001 真人
5008 loli
5111 其他
综艺
参数值 说明
0 全部
3001 脱口秀
3002 真人秀
3003 选秀
3004 美食
3005 旅游
3006 汽车
3007 访谈
3008 纪实
3009 搞笑
3111 其他
国家/地区参数:area
电视剧
参数值 说明
0 全部
1001 大陆
1003 韩国
1006 香港
1007 泰国
1008 台湾
1009 美国
1111 其他
电影
参数值 说明
0 全部
2004 香港
2002 美国
2001 大陆
2007 韩国
2006 台湾
2008 日本
2111 其他
动漫
参数值 说明
0 全部
5005 日本
5001 大陆
5004 美国
5006 韩国
5111 其他
综艺
参数值 说明
0 全部
3001 大陆
3004 韩国
3002 香港
3005 日本
3003 台湾
3006 美国
3111 其他
年代参数:year
电视剧
参数值 说明
0 全部
2012 2012年
2011 2011年
2010 2010年
2009 2009年
2008 2008年
9999 更早
电影
参数值 说明
0 全部
2012 2012年
2011 2011年
2010 2010年
2009 2009年
2008 2008年
9999 更早
综艺
参数值 说明
0 全部
2012 2012年
2011 2011年
2010 2010年
2009 2009年
2008 2008年
9999 更早
排序参数:order
电影
参数值 说明
1 正在热播
3 最近更新
2 最受好评
动漫
参数值 说明
1 正在热播
3 最近更新

3. 返回参数

3.1 字段说明
父字段 字段 字段类型 字段描述
e provider string 服务方名称:searches.soku.top
code int 错误码,详细见错误代码:code
desc string 错误描述
cost int 耗时,单位:毫秒
total int 结果条数
data JSONArray 节目列表见节目列表详细字段:data
节目列表详细字段:data
父字段 字段 字段类型 字段描述
data name string 节目名称
performer JSONArray[String] 主演
director JSONArray[String] 导演
genre JSONArray[String] 类型
score double 分数
vpic String 图片地址
brief String 影片描述
playurl String 默认播放地址
trailerUrl String 预告片播放地址
hd int 清晰度, 详细见清晰度代码:hd
totalvv int 播放量
displaystatus String 影片描述
paid int 付费标志,详细见付费标志:paid
releaseDate string 上映时间
releaseYear String 上映年代
programmeSite JSONArray 各个站点节目信息
各个站点节目信息:programmeSite
字段 字段类型 字段描述
siteId int 站点标示ID,详细见站点说明:siteId
hd int 该站点该节目的清晰度,详细见清晰度代码:hd
displaystatus String 该站点该节目的状态,如:正片
episode JSONArray 该站点的播放源信息
该站点的播放源信息:episode
字段 字段类型 字段描述
name String 片名
url String 播放地址
清晰度代码:hd
参数值 说明
1 高清
2 超清
付费标志:paid
参数值 说明
1 付费
站点说明:siteId
参数值 说明
14 优酷
1 土豆
19 爱奇艺
3 新浪
6 搜狐
17 乐视
2 56
9 激动
15 CNTV
27 腾讯
16 电影网
错误代码:code:
参数值 说明
0 正确
3501 警告
3502 参数错误
3503 系统异常
3504 权限不足

4. 响应示例

		{
           "e": {
                   "provider": "searches.soku.top",
                   "code": 0,
                   "desc": "OK"
           },
           "total": 30,
           "cost": 31,
           "data": [
           {
                   "preSize": 45,
                   "programmeId": 231057,
                   "name": "宝岛双雄",
                   "director": ["张训玮"],
                   "performer": [
                           "房祖名",
                           "夏雨",
                           "邓家佳"
                   ],
                   "host": [],
                   "singer": [],
                   "genre": [
                           "动作",
                           "爱情",
                           "喜剧"
                   ],
                   "score": 7.175000190734863,
                   "vpic": " http://res.mfs.ykimg.com/050D00004FC87EE89792735DF209D1AC",
                   "brief": "举世闻名的《富甲山水图》各一半珍藏于大陆和台湾的故宫博物院,这是首次合璧在台北故宫展出。国际上的江湖大盗纷纷闻讯而至。来自大洋彼岸的国际盗宝集团派出两名美女盗贼假扮保安人员混入故宫盗走画卷。盗贼得手之际恰好撞到年轻的保安员小杰(房祖名 饰),双方发生了激烈搏斗。正当身手不凡的小杰终于占了上风要将盗贼擒拿之际,一名正在故宫参观的大陆游客\u201c英雄救美\u201d放走了美女大盗反而制服了小杰。当身穿便服的小杰终于让对方相信了自己是保安人员,美女才是盗贼的时候,这名游客追悔莫及。原来这名叫大海(夏雨 饰)的游客是一名来自北京的小区保安。与此同时,比误放盗贼更\u201c乌龙\u201d的事情发生了,小杰被保安总部认为是盗窃集团的内应,大海则发现旅行团的大巴早已消失,自己\u201c脱团\u201d了。小杰不仅要躲避警方的追捕而且必须要亲自找回画卷才能证明自己的清白;举目无亲的大海也\u201c被成为\u201d了小杰的\u201c同谋\u201d,他则是要找到他的旅行团才能证明自己的身份。于是,来自两岸的两名\u201c屌丝\u201d保安开始了在宝岛\u201c亡命天涯\u201d的旅程...... ",
                   "playurl": "http://v.youku.com/v_show/id_XNDI0MjY4MjI0.html",
                   "trailerUrl": "http://v.youku.com/v_show/id_XMzk5MzMwMjQw.html",
                   "hd": 2,
                   "displaystatus": "正片",
                   "paid": 1,
                   "totalvv": 11442719,
                   "detailUrlYouku": "http://www.youku.com/show_page/id_z37c620522c1211e19498.html",
                   "detailUrlSoku": "/detail/show/XOTI0MjI4",
                   "releaseDate": "2012-06-15",
                   "releaseYear": "2012",
                   "completed": 1,
                   "animeEdition": "0",
                   "haveMinorList": true,
                   "programmeSite": [{
                           "pre": "\t",
                           "siteId": 14,
                           "hd": 2,
                           "episodeCollected": 1,
                           "displaystatus": "正片",
                           "episode": [{
                           "pre": "\t\t",
                           "name": "宝岛双雄",
                           "url": "http://v.youku.com/v_show/id_XNDI0MjY4MjI0.html",
                           "orderStage": 1,
                           "lastUpdate": 1341763200,
                            "tagType": 0
                           }]
                   }]
           },
           .........
           ]
   }