优酷开放云

帮助文档
>
OPEN API
>
视频搜索
>
关键词排行榜

关键词排行榜

1. 接口描述

URL	https://openapi.youku.com/router/rest.json
功能描述	关键词排行榜
返回格式	Json，UTF8
HTTP请求方式	GET
当前接口版本	V3

2. 系统参数

参数名	参数全称	必选	参数类型	参数描述
action	action	true	String	youku.search.keyword.rankinglist
client_id	client_id	true	String	应用的client id
access_token	access token	false	String	oauth2的token
format	format	false	String	可选，指定响应格式。默认保持代理接口格式化,目前支持格式为xml,json,text
timestamp	timestamp	true	String	客户端当前时间戳，精确到秒，timestamp与开放平台请求时间误差为6分钟
version	version	true	String	3.0
sign	sign	true	String	对API调用参数（除sign外）的md5加密值。详情见签名方法

3. 业务参数

参数名	参数类型	必选	参数默认值	参数描述
mode	String	false	day	天排行榜数据:day周排行榜行数据:week,月排行榜数据:month
channel	String	false		分类：综艺
limit	int	false	50	1-300之间

4. 返回参数

父字段	字段	字段类型	字段描述
e	provider	string	服务方名称：searches.soku.kubox
	code	int	错误代码
	desc	String	错误描述
total		String	结果条数
cost		int	耗时
data	keyword	String	搜索词
	cate	String	分类ID，无法对应则为空””，1 电视剧，2 电影，3 综艺，4 音乐，5 动漫， 6 明星，7 体育， 8 教育， 9 纪录片，101 科教， 102 搞笑
	program	string	节目ID，无法对应则为空””
	querycount	int	搜索量
	trend	int	趋势：天排行榜独有参数

5. 调用示例

https://openapi.youku.com/router/rest.json?opensysparams={"action": 
"youku.search.keyword.rankinglist", "version": "3.0", "timestamp": 
1453721250, "access_token": "d9ce66ced641240836cf6011a4c195bc", 
"sign": "0824d9542315e54c219217ceaae17c15", "format": "json", 
"client_id": "163d4fd10c7f9a28"}&caller=NOVA

6. 响应示例

{
      "e": {
      "provider":"searches.soku.top",
      "code":0,
      "desc":"OK"
      },
      "total":2,
      "cost":2,
      "data": [
      {
      "keyword":"后宫甄嬛传",
      "cate":"1",
      "program":"18629",
      "querycount":75065,
      "trend":-3464
      },
      {
      "keyword":"偏偏爱上你",
      "cate":"1",
      "program":"",
      "querycount":73190,
      "trend":-19353
      }
      ]
}

7. 异常示例

    "e": {
        "provider":"searches.soku.top",
        "code":1502,
        "desc":"mode 参数错误"
    }

8. 注意事项

请预留“X-Caller”和“User-Agent”以标识调用方名称和调用方平台如果调用方不是请求的发起方而是代理方，请设置“X-Forwarded-For”记录发起方的真实IP

接口描述
系统参数
业务参数
返回参数
调用示例
响应示例
异常示例
注意事项

帮助文档

关键词排行榜

1. 接口描述

2. 系统参数

3. 业务参数

4. 返回参数

5. 调用示例

6. 响应示例

7. 异常示例

8. 注意事项