关键词排行榜

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 intfalse 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