UapiProUApiPro
杂项

查询热榜

0次调用
1 积分/次

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

GET
uapis.cn
/api/v1/misc/hotboard
查询参数
6
type
string
required
你想要查询的热榜平台。请从中选择。
time
integer
Pro

时光机模式：毫秒时间戳，返回该时间附近最近可展示的历史热榜快照。不传则返回当前实时热榜。

keyword
string
Pro

搜索模式：搜索关键词，在指定历史时间范围内搜索包含该关键词的条目。需配合 time_start 和 time_end 使用。

time_start
integer
Pro

搜索模式必填：搜索起始时间戳（毫秒），需位于该平台历史数据覆盖范围内。

time_end
integer
Pro

搜索模式必填：搜索结束时间戳（毫秒），需晚于 time_start 且位于该平台历史数据覆盖范围内。

limit
integer
Pro

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

功能概述

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

三种使用模式

默认模式

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

时光机模式

传 type + time 参数，返回指定时间附近最近可展示的历史热榜快照。

搜索模式

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

小贴士

返回的update_time 统一为 UTC 时间，采用 ISO 8601 格式并以 Z 结尾（例如 2026-03-20T21:39:16.000Z）。如需按北京时间展示，请自行 +8 小时。

查询参数

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

时光机模式：毫秒时间戳，返回该时间附近最近可展示的历史热榜快照。不传则返回当前实时热榜。

keyword
string可选

搜索模式：搜索关键词，在指定历史时间范围内搜索包含该关键词的条目。需配合 time_start 和 time_end 使用。

time_start
integer可选

搜索模式必填：搜索起始时间戳（毫秒），需位于该平台历史数据覆盖范围内。

time_end
integer可选

搜索模式必填：搜索结束时间戳（毫秒），需晚于 time_start 且位于该平台历史数据覆盖范围内。

limit
integer可选

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

响应

200 / 请求成功

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

格式 1默认模式 / 时光机模式
JSON
{
  "type": "weibo",
  // 热榜更新时间，UTC 时间（ISO 8601 格式，以 Z 结尾）。时光机模式下对应返回快照的更新时间。
  "update_time": "2026-03-20T21:39:16.000Z",
  // 时光机模式返回的快照实际时间戳（毫秒）。当前热榜模式下通常不返回。
  "snapshot_time": 1700000000000,
  // 热榜条目列表。
  "list": [
    {
      // 额外信息，不同平台该字段内容不同，例如微博热搜的标签（如“新”“爆”）。
      "extra": {},
      "hot_value": "1234567",
      "index": 1,
      "title": "今天天气真好",
      "url": "https://s.weibo.com/weibo?q=%23%E4%BB%8A%E5%A4%A9%E5%A4%A9%E6%B0%94%E7%9C%9F%E5%A5%BD%23",
      // 封面图 URL，音乐类热榜返回专辑封面，其他平台一般不返回。
      "cover": "https://p1.music.126.net/xxx/109951170483249998.jpg"
    }
  ]
}
格式 2搜索模式
JSON
{
  "type": "weibo",
  // 搜索关键词。
  "keyword": "AI",
  // 匹配到的结果数量。
  "count": 0,
  // 搜索结果数组。
  "results": [
    {
      "title": "AI技术突破",
      "hot_value": "999999",
      "url": "https://example.com"
    }
  ]
}

400 / 错误的请求

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

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Invalid hotboard type specified."
}

500 / 服务器内部错误

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

JSON
{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "Failed to process hotboard data."
}

502 / 网关错误

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

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Failed to fetch hotboard from upstream source."
}
下一篇查询电影票房
【免费】全网热榜聚合API - 微博/知乎/B站/抖音40+平台热搜 | UAPI