热搜榜单合并数据检索接口
更新时间：2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述：检索热搜榜单合并后的数据
请求方式：post
请求地址：
clues/hotranklist/search
请求参数格式：application/json
输入参数
参数名称
类型
是否必填
描述
startTime
string
否
开始时间，表示查询这个时间之后的热搜，格式yyyyMMdd或yyyyMMddHHmmss
endTime
string
否
结束时间，表示查询这个时间之后的热搜，格式yyyyMMdd或yyyyMMddHHmmss
searchWord
string
否
搜索的关键字，多个关键字使用“,”分隔，多个关键字必须同时包含才会返回，输入的关键词总长度100个字符以内。注意关键词不能包含{、}、“ 等特殊字符
searchWordOr
string
否
搜索的关键字，多个关键字使用“,”分隔，多个关键字包含任意一个都会返回，输入的关键词总长度100个字符以内。注意关键词不能包含{、}、“ 等特殊字符
pageNum
integer
否
页码，首页及默认为0
pageSize
integer
否
每页数据，默认20
sorts
string
否
结果集排序方式，通过“+”、“-”和数据字段来控制正序或倒序，示例-pubTime表示按照文章发布时间倒叙，支持多字段一起排序，比如【-loadTime,+pubTime】表示先根据入库时间倒序排列，如果时间一致时在根据发布时间正序排序。 具体本接口支持的排序字段如下：crawlTime(采集时间)、order(原始榜单排序) 默认排序：-crawlTime;+order
输出参数
参数名称
类型
描述
sid
string
当前记录的id
keyword
string
热搜词/热词
indexCount
integer
榜单中的指数/热度等
order
integer
原始榜单的排名
url
string
原始url连接
startTime
string
上榜时间
endTime
string
下榜时间
ranklistName
string
榜单名称
label
string
榜单的标签类型，可选值的含义如下：15：梗、14：置顶、13：热门、12：独家、11：商、10：首发、9：沸、8：议、7：爆、6：热、5：新、4：当事人、3：升、2：平、1：降、0：无
commentCount
integer
评论数
调用示例
{
"startTime":"20230921",
"endTime":"20230922",
"ranklistCategory":"微博热搜榜"
}
输入示例
{
"startTime":"20230921",
"endTime":"20230922",
"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":"微博热搜榜"
}
]
}
}
接口说明
检索的数据是合并后的榜单数据，根据输入的起止时间只要在这个范围内的榜单都可以查询。
在线测试
请求方式：
POST
startTime：
endTime：
searchWord：
searchWordOr：
industryName：
ranklistCategory：
pageNum：
pageSize：
sorts：
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。