杂项

查询热榜

0次调用
1 积分/次

想快速跟上网络热点?这个接口让你一网打尽各大主流平台的实时热榜/热搜!

功能概述

你只需要指定一个平台类型,就能获取到该平台当前的热榜数据列表。每个热榜条目都包含标题、热度值和原始链接。非常适合用于制作信息聚合类应用或看板。

三种使用模式

默认模式

只传 type 参数,返回该平台当前的实时热榜。

时光机模式

type + time 参数,返回最接近指定时间的热榜快照。如果不可用或无数据,会返回空。

搜索模式

type + keyword + time_start + time_end 参数,在指定时间范围内搜索包含关键词的热榜条目。可选传 limit 限制返回数量。

查询参数

type
string必填
你想要查询的热榜平台。请从中选择。
time
integer可选

时光机模式:毫秒时间戳,返回最接近该时间的热榜快照。不传则返回当前实时热榜。

keyword
string可选

搜索模式:搜索关键词,在历史热榜中搜索包含该关键词的条目。需配合 time_start 和 time_end 使用。

time_start
integer可选

搜索模式必填:搜索起始时间戳(毫秒)。

time_end
integer可选

搜索模式必填:搜索结束时间戳(毫秒)。

limit
integer可选

搜索模式下最大返回条数,默认 50,最大 200。

响应

200 / 请求成功

查询成功!返回指定平台的热榜列表数据。不同模式返回格式不同:默认模式和时光机模式返回 list 数组;搜索模式返回 results 数组。

格式 1默认模式 / 时光机模式
JSON
格式 2搜索模式
JSON

400 / 错误的请求

请求参数错误。你提供的 type 参数不是我们支持的平台类型,请检查拼写。

JSON

500 / 服务器内部错误

获取热榜失败。服务器在处理数据时发生内部错误。

JSON

502 / 网关错误

暂时无法获取相关数据,请稍后重试。

JSON