快手榜单查询接口
更新时间:2026-03-20 11:10:36
API测试
申请API调用
基本信息
接口描述:查询快手的媒体榜单数据,包括日榜、周榜、月榜、季度榜等四种类型。
请求方式:post
请求地址:
ranklist/kuaishou/pageList
请求参数格式:application/x-www-form-urlencoded
输入参数
参数名称
类型
是否必填
描述
listTimeRange
string
是
榜单时间范围(日榜:YYYYMMDD,周、月、季榜:YYYYMMDD-YYYYMMDD)
listCycle
string
是
榜单类型:day:日榜/week:周榜/month:月榜/quarter:季榜
pageNum
string
否
返回结果集页码,首页及默认值均为0
pageSize
string
否
每页返回结果集数量,默认值20,最大值不可超过100
sortOrder
string
否
结果集排序方式,通过“+”、“-”和数据字段来控制正序或倒序,示例-listCeiIndex表示按照媒体传播指数倒叙,支持多字段一起排序,比如【-listCeiIndex,+reportNum】表示先根据传播指数倒序排列,如果指数一致时在根据发文数正序排序。接口支持的排序字段如下:listCeiIndex(传播指数)、reportCount(发文量)、originalCount(原创稿件量)等
ranklistid
string
否
支持根据自定义的榜单查询结果
siteName
string
否
多值字段;分隔 查询站点榜单 查询榜单个数最大值不可超过100
输出参数
参数名称
类型
描述
code
string
接口状态码,200为正常,其他为错误码
msg
string
接口的错误描述信息
data
object
接口内的具体返回信息
data.content
string
数据分页对象
siteName
string
站点名称
reportCount
string
发稿数
listCeiIndex
string
传播力指数
followersCount
string
粉丝数
commentCount
string
评论数
approveCount
string
点赞数
rttCount
string
转发数/分享数
totalElements
string
全部对象个数
totalPages
string
总页数
number
string
页码
size
string
页面大小
numberOfElements
string
当前页对象个数
requestid
string
当前请求的唯一ID,反馈问题时直接提交此信息
ranklistid
integer
支持根据自定义的榜单查询结果
调用示例
http://[域名]/opens/api/ranklist/kuaishou/pageList
输入示例
listTimeRange=20210903&listCycle=day
输出示例
{
"code": 200,
"msg": "请求成功",
"data": {
"content": [
{
"siteName": "武山融媒",
"reportCount": "275",
"listCeiIndex": "692.89",
"followersCount": "391000",
"commentCount": "50382",
"approveCount": "454075",
"rttCount": "0"
}
],
"totalElements": 348,
"totalPages": 348,
"number": 0,
"size": 1,
"numberOfElements": 1
},
"requestid": "4a8930dd-202a-11ec-9f40-000af7e86914"
}
接口说明
无
在线测试
请求方式:
POST
*listTimeRange:
mediaIndustryCatalog:
mediaAreaCatalog:
*listCycle:
pageNum:
pageSize:
sortOrder:
ranklistid:
siteName:
确定
重置
请求结果
错误码
其他错误码详见
公共错误码。