基础排行榜单数据同步接口
更新时间：2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述：ranklistCategory必须指定某一个具体的榜单，不可以多值查询。
请求方式：post
请求地址：
clues/hotranklist/pageList
请求参数格式：application/json
输入参数
参数名称
类型
是否必填
描述
startLoadTime
string
是
开始入库时间，表示查询这个时间之后的热搜，格式yyyyMMdd或yyyyMMddHHmmss
endLoadTime
string
是
结束入库时间，表示查询这个时间之前的热搜，格式yyyyMMdd或yyyyMMddHHmmss
ranklistCategory
string
是
榜单分类：微博热搜榜等，只支持按照单个具体的榜单来查询。具体支持榜单见数据字典的说明
pageNum
integer
否
页码，首页及默认为0
pageSize
integer
否
每页数据，默认20
sorts
string
否
结果集排序方式，通过“+”、“-”和数据字段来控制正序或倒序，示例-pubTime表示按照文章发布时间倒叙，支持多字段一起排序，比如【-loadTime,+pubTime】表示先根据入库时间倒序排列，如果时间一致时在根据发布时间正序排序。 具体本接口支持的排序字段如下：loadTime(入库时间) 默认排序：+loadTime
输出参数
参数名称
类型
描述
sid
string
当前记录的id
keyword
string
热搜词/热词
indexCount
integer
榜单中的指数/热度等
order
integer
原始榜单的排名
url
string
原始url连接
crawlTime
string
采集时间
loadTime
string
入库时间
siteName
string
采集的站点
channel
string
采集的频道
ranklistName
string
榜单名称---隐藏
label
string
榜单的标签类型，这个字段返回对应的数字所代表的中文含义，不直接返回数字，具体映射关系见库表结构中的说明
调用示例
{
"startLoadTime":"20230701",
"endLoadTime":"20230713",
"ranklistCategory":"快手热搜榜"
}
输入示例
{
"startLoadTime":"20230701",
"endLoadTime":"20230713",
"ranklistCategory":"快手热搜榜"
}
输出示例
{
"code":200,
"msg":"成功",
"data":{
"number":0,
"size":1,
"numberOfElements":1,
"totalPages":3,
"totalElements":3,
"content":[
{
"sid":"lasjdof23r203",
"keyword":"热搜词",
"indexCount":398923,
"order":3,
"url":"http://qefwqoe23.com",
"startTime":"2022-11-07 23:56:08",
"endTime":"2022-11-07 23:56:08",
"ranklistName":"微博热搜榜"
}
]
}
}
接口说明
ranklistCategory必须指定某一个具体的榜单，不可以多值查询。
在线测试
请求方式：
POST
*startLoadTime：
*endLoadTime：
*ranklistCategory：
pageNum：
pageSize：
sorts：
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。