多条视频详细信息(videos/show_batch)

接口

URL https://openapi.youku.com/v2/videos/show_batch.json

HTTP方法 GET

返回格式 json

授权/登录 false

URL	https://openapi.youku.com/v2/videos/show_batch.json
HTTP方法	GET
返回格式	json
授权/登录	false

参数

参数类型必选默认值说明示例

client_id string true 应用Key

video_ids string true 视频ID 多个用逗号分隔

ext string false 视频扩展信息返回，多个用逗号分隔 thumbnails,show, dvd,reference

参数	类型	必选	说明	示例
client_id	string	true	应用Key
video_ids	string	true	视频ID 多个用逗号分隔
ext	string	false	视频扩展信息返回，多个用逗号分隔	thumbnails,show, dvd,reference

返回结果

3.1 字段说明

video 视频

参数	类型	允许为空	示例
id	string	false	视频唯一ID
title	string	false	视频标题
link	string	false	视频播放链接
thumbnail	string	false	视频截图（小）
bigThumbnail	string	false	视频截图（大）
duration	int	false	视频时长，单位：秒
category	string	false	视频分类
state	string	false	视频状态 normal: 正常 encoding: 转码中 fail: 转码失败 in_review: 审核中 blocked: 已屏蔽
created	string	false	创建时间
published	string	false	发布时间
description	string	true	视频描述
player	string	false	播放器
public_type	string	false	公开类型 all: 公开 friend: 仅好友观看 password: 输入密码观看
copyright_type	string	false	版权所有 original: 原创 reproduced: 转载
user	object	false	上传用户对象
tags	string	false	视频标签，多个标签用逗号分隔
view_count	int	false	总播放数
favorite_count	int	false	总收藏数
comment_count	int	false	总评论数
up_count	int	false	总顶数
down_count	int	false	总踩数
operation_limit	array	true	操作限制 COMMENT_DISABLED: 禁评论 DOWNLOAD_DISABLED: 禁下载
streamtypes	array	true	视频格式 flvhd flv 3gphd 3gp hd hd2
blocked_reason	object	true	屏蔽理由，当视频状态为blocked
thumbnails	object	true	多张截图（默认不返回）
show	object	true	所属节目对象（默认不返回）
dvd	object	true	DVD属性对象（默认不返回）
source	object	true	上传来源
reference_count	int	true	引用数

blocked_reason 屏蔽理由

参数	类型	允许为空	说明	示例
no	int	false		屏蔽理由号
desc	string	false		屏蔽理由描述

thumbnails 多张截图

参数	类型	允许为空	示例
seq	int	false	截图序号
url	string	false	截图地址
is_cover	int	false	是否为封面 1.是 0.不是

user 上传用户

参数	类型	允许为空	示例
id	string	false	用户ID
name	string	false	用户名
link	string	false	用户个人空间地址

show 节目信息

参数	类型	允许为空	示例
id	string	false	节目ID
name	string	false	节目名称
link	string	false	节目页地址
type	string	false	节目视频类型正片预告片花絮
seq	int	true	节目视频中序号
stage	int	true	节目中视频的集数或期数 (日期型使用YYYYMMDD）非节目正片此字段为null
collecttime	int	true	视频收录到节目的时间 (YYYY-MM-DD HH:NN:SS)

dvd DVD信息

参数	类型	允许为空	示例
point	object	true	点对象
audiolang	object	true	音频语言
title	string	false	视频标题
state	string	false	视频状态
tv_starttime	date	false	电视台播出时间
createtime	int	true	创建时间YYYY-MM-DD HH:NN:SS
rc_title	string	true	编辑推荐标题 (视频为综艺类时显示)
desc	string	false	单集描述如果为空使用description字段
person	object	false	人物

point

参数	类型	允许为空	示例
head	int	true	片头点，单位：毫秒
tail	int	true	片尾点，单位：毫秒
story	object	true	故事点

story

参数	类型	允许为空	示例
start	int	true	点位置，单位：毫秒
title	string	true	点标题
desc	string	true	点描述

audiolang

参数	类型	允许为空	示例
id	string	true	视频ID
url	string	true	视频URL
lang	string	true	音频语言

person

参数	类型	允许为空	示例
id	string	false	人物ID
name	string	false	人物姓名
start	date	true	出场时间
type	string	false	人物类型
link	string	false	人物详细链接

source 上传来源

参数	类型	允许为空	示例
id	int	true	来源ID
name	string	true	来源名称
link	string	true	来源链接

3.2 JSON

 {
           "id" : "XNDY5Njc0MTA4",
           "title" : "康熙来了 121101",
           "link" : "http://v.youku.com/v_show/id_XNDY5Njc0MTA4.html",
           "thumbnail" : "http://g2.ykimg.com/01270F1F46509251F539D10123193CD2CB70CC-5896-F53E-B869-61E819861E71",
           "duration" : "2675.36",
           "category" : "综艺",
           "state" : "normal",
           "created" : "2011-07-15 09:00:42",
           "published" : "2011-07-15 09:00:42",
           "description" : "康熙来了",
           "player" : "http://player.youku.com/player.php/sid/XNDY5Njc0MTA4/v.swf",
           "public_type" : "all",
           "copyright_type" : "reproduced",
           "user" :
           {
                   "id" : 58011986,
                   "name" : "康熙来了2010",
                   "link" : "http://i.youku.com/u/UMjMyMDQ3OTQ0"
           },
           "tags": "康熙来了",
           "view_count" : 646437,
           "favorite_count": "124",
           "comment_count": "547",
           "up_count": 3060,
           "down_count": 724,
           "reference_count": 0,
           "operation_limit": [ ],
           "streamtypes": [
                   "hd2",
                   "flvhd",
                   "mp4",
                   "3gp",
                   "3gphd"
               ],
               "thumbnails": [
                   {
                        "seq": 1,
                        "url": "http://g3.ykimg.com/01270F1F46509251F204590123193C80F22A26-EDE9-96A1-EB60-8FA55743C21C",
                        "is_cover": 0
                   },
                   {
                        "seq": 2,
                        "url": "http://g4.ykimg.com/01270F1F46509251F37D7D0123193C0E845A38-7A41-3CCA-00A9-2908EF58F301",
                        "is_cover": 0
                   },
                   {
                        "seq": 3,
                        "url": "http://g1.ykimg.com/01270F1F46509251F4E7800123193CCF7AB6E4-D027-1157-4F9F-D5783E051474",
                        "is_cover": 0
                   },
                   {
                        "seq": 4,
                        "url": "http://g2.ykimg.com/01270F1F46509251F539D10123193CD2CB70CC-5896-F53E-B869-61E819861E71",
                        "is_cover": 1
                   },
                   {
                        "seq": 5,
                        "url": "http://g3.ykimg.com/01270F1F46509251F625770123193C706B1FB5-4BAB-9077-2701-498C2E1DB452",
                        "is_cover": 0
                   },
                   {
                        "seq": 6,
                        "url": "http://g4.ykimg.com/01270F1F46509251F7DA0F0123193C43216832-6BF1-98C7-A93B-F5F003D06E3A",
                        "is_cover": 0
                   },
                   {
                        "seq": 7,
                        "url": "http://g1.ykimg.com/01270F1F46509251F8DC940123193C8074B788-FA97-3BAE-0273-AAECBCBAC873",
                        "is_cover": 0
                   },
                   {
                        "seq": 8,
                        "url": "http://g2.ykimg.com/01270F1F46509251F966270123193C863C7E46-5504-D446-3BAB-2A056EC1A550",
                        "is_cover": 0
                   }
               ],
               "show": {
                   "id": "2ab71ff032cb11e196ac",
                   "name": "康熙来了 2012",
                   "link": "http://www.youku.com/show_page/id_z2ab71ff032cb11e196ac.html",
                   "type": "正片",
                   "seq": "215",
                   "stage": "20121101"
               },
               "dvd": {
                   "point": {
                       "story": [
                        {
                            "start": "307043",
                            "title": "张艾亚大秀台步 蹩脚姿势被嘲笑",
                            "desc": ""
                        },
                        {
                            "start": "1060907",
                            "title": "陈汉典野战造型 半裸狂跳骑马舞",
                            "desc": ""
                        },
                        {
                            "start": "1736034",
                            "title": "陈汉典大展身手 跳远似飞引欢呼",
                            "desc": ""
                        },
                        {
                            "start": "2046152",
                            "title": "小S教瘦身秘诀 超速竞走秀曲线",
                            "desc": ""
                        }
                     ]
                  },
                  "tv_starttime": "2012-11-01 22:00:00",
                  "desc": "本期《康熙来了》沈玉琳、许建国、王尹平、余筱萍和张艾亚纷纷挑战运动项目，他们每人在球场上表现如何呢？陈汉典为何现场大秀骑马舞？小S竟也放下身段，快速竞走传授她的曲线秘诀。敬请关注！",
                  "person": [
                    {
                         "id": "317206",
                         "name": "余筱萍",
                         "start": "112494",
                         "type": "guest",
                         "link": "http://www.youku.com/star_page/uid_UMTI2ODgyNA=="
                    },
                    {
                         "id": "330092",
                         "name": "沈玉琳",
                         "start": "68347",
                         "type": "guest",
                         "link": "http://www.youku.com/star_page/uid_UMTMyMDM2OA=="
                    },
                    {
                         "id": "419241",
                         "name": "许建国",
                         "start": "490796",
                         "type": "guest",
                         "link": "http://www.youku.com/star_page/uid_UMTY3Njk2NA=="
                    },
                    {
                         "id": "421849",
                         "name": "张艾亚",
                         "start": "313980",
                         "type": "guest",
                         "link": "http://www.youku.com/star_page/uid_UMTY4NzM5Ng=="
                    },
                    {
                         "id": "422446",
                         "name": "王尹平",
                         "start": "245714",
                         "type": "guest",
                         "link": "http://www.youku.com/star_page/uid_UMTY4OTc4NA=="
                     }
                  ]
               },
                              "source": {
                    "id": 1,
                    "name": "优酷站内WEB上传",
                    "link": "http://www.youku.com/v_up/"
               }
   }

错误返回，见错误代码定义

文档目录

多条视频详细信息(videos/show_batch)

多条视频详细信息(videos/show_batch)