关键词排行榜
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