接口说明
更新时间:2019-06-14
创建任务
服务域名
接口地址:trends.baidubce.com
备注:该接口需在百度智能云网络环境调用。(可在百度智能云主机相关产品,例如云服务器BCC上进行调用)
方法
方法 | Api | 说明 |
---|---|---|
GET | /openapi/hotquery | 请求某地区地域风向标数据 |
请求参数
名称 | 必填 | 说明 |
---|---|---|
user_key | 是 | 系统分配user_key |
token | 是 | token值,值为hash_hmac('sha1', $user_key, $timestamp, $user_secret) |
timestamp | 是 | 任务提交时的时间戳(数字,例如:1477238400) |
params_dict | 是 | 请求所携带的参数列表 |
params_dict参数结构
名称 | 说明 |
---|---|
contry | 国家,必填,若为""默认为中国 |
province | 省,必填,若要取全国数据,值置为""即可 |
city | 城市,必填,若取全国/全省数据,值置为""即可 |
county | 区,必填,若取全国/全省/全市数据,值置为""即可 |
calc_type | 表示范围级别,取值为country, province,city,county,默认全国 |
top_num | 返回热搜词的数量,取值范围 0-1000 默认100 |
time_from | 开始时间戳,Unix时间戳,系统只能识别到小时。选填,若为空,则为time_to前推1小时,最大值为time_to前推24小时。 |
time_to | 结束时间戳,Unix时间戳,系统只能识别到小时。选填,若为空取当前时间。 |
注意
- 暂时只支持用户获取2016年10月14日以后的数据。
- 目前只支持用户获取最近3个月内某段时间范围(最长24小时)的数据。
- 数据粒度为小时,系统只能识别time_from和time_to的小时位,例如:若time_from=1477961446,time_to=1477968646,将Unix时间戳转换为北京时间为:2016/11/1 8:50 ~ 2016/11/1 10:50,此时系统将返回8点、9点、10点的数据。
params_dict示例:
params_dict = {
"province":"江苏",
"city":"",
"calc_type":"province",
"time_from":1478793652,
"time_to":1478876452,
"top_num":10
}
返回参数
字段 | 说明 |
---|---|
Retcode | 响应码:101:token 错误或过时,200:请求成功,401:缺少必要参数,402:参数解析错误,501:系统错误,503:用户权限错误 |
Total | 返回top query的个数 |
result_list | 按热度逆序排列 |
result_list示例:
{"code":200,"msg":"请求成功","data":[["淘宝",60255],["斗鱼tv",48193],["淘宝网",47442],["幻城",43759],["京东",43686],["斗鱼",42716],["天猫",37722],["京东商城",29436],["优酷",21418],["爱奇艺",20582]]}
请求示例
请求示例请见sample_code,sample_code编写语言为python,在conf.py中填写相关信息,即可进行调用。
其中,user_key和user_secret在开通服务后,由百度智能云提供。
获取AK/SK的方法请参看如何获取AK / SK。
示例代码:下载Sample Code