通过标签搜索视频

1. 接口描述

URL https://openapi.youku.com/v2/searches/video/by_tag.json
功能描述 通过标签搜索视频
返回格式 Json,UTF8
HTTP请求方式 GET
授权/登录 false
当前接口版本 V2
其他接口版本

2. 业务参数

参数名 参数类型 必选 默认值 参数描述 示例
client_id string true 应用Key
tag string true 标签 多个标签逗号分隔 优酷拍客
category string false 分类 综艺 娱乐 教育 旅游 时尚 母婴 资讯 原创 女性 搞笑 音乐 电影 电视剧 体育 游戏 动漫 广告 生活 汽车 科技 其他
period string false today 时间范围 today: 今日 week: 本周 month: 本月 history: 历史 today
orderby string false relevance 排序 published: 发布时间 view-count: 总播放数 comment-count: 总评论数 reference-count: 总引用数 favorite-count: 总收藏数 relevance: 相关度 relevance
userid int/string false 指定用户查找(指定用户将不支持多标签搜索,并且仅支持排序,其他参数失效)
page int false 1 页数 1
count int false 20 页大小 20

3. 返回参数

video 视频
参数名 参数类型 允许为空 参数描述 示例
id String false 视频唯一ID
title string false 视频标题
link String false 视频播放链接
thumbnail string false 视频截图
duration String false 视频时长,单位:秒
category string false 视频分类
tags string false 视频标签,多个标签用逗号分隔
state string false 视频状态 normal: 正常 encoding: 转码中 encode_fail: 转码失败 auditing: 审核中 masked: 已屏蔽
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
user 上传用户
参数名 参数类型 允许为空 参数描述 示例
id int false 用户ID
name string false 用户名
link String false 用户个人空间地址

4. 响应示例

{
       "total" : 100,
       "videos" :
       [
           {
               "id" : "XMjg1MTcyNDQ0",
               "title" : "泡芙小姐的灯泡 11",
               "link" : "http://v.youku.com/v_show/id_XMjg1MTcyNDQ0.html",
               "thumbnail" : "http://g4.ykimg.com/0100641F464E1FC...",
               "duration" : "910",
               "category" : "原创",
               "tags" : "优酷出品,互象动画,泡芙小姐",
               "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"]
           }
           …
       ]
   }
        	 

5. 错误代码