汽水四榜API DOCUMENTATION← 返回榜单

QISHUI CHARTS · API REFERENCE

接口文档

无需鉴权JSON支持跨域实时请求

通过一个接口获取热门搜索、热歌榜、新歌榜和音乐人歌曲榜的最新完整数据。

01 · ENDPOINT

获取汽水四榜

查看实时 JSON ↗
GETPOST/api/qishui/charts

GET 与 POST 均会重新请求官方数据并返回相同结构。建议普通调用使用 GET。

cURL调用示例
curl -X GET "/api/qishui/charts"
JavaScript调用示例
const response = await fetch("/api/qishui/charts");
const data = await response.json();

console.log(data.charts.hotSong.items);
02 · RESPONSE

响应结构

capturedAt

本次采集时间，ISO 8601 格式。

charts

四张榜单的数据对象。

字段榜单说明
charts.hotSearch热门搜索20 个手机端展示位，推广项也计入总数
charts.hotSong热歌榜官方返回的完整歌曲榜单
charts.newSong新歌榜官方返回的完整新歌榜单
charts.musicianSong音乐人歌曲榜官方返回的完整音乐人作品榜单
03 · FIELDS

热门搜索条目

positionnumber
手机端展示位置，从 1 开始
ranknumber | null
真实搜索排名；推广项为 null
kind"query" | "promotion"
搜索词或推广项
keywordstring
展示文本
tagsstring[]
热、新等标签
rankDeltanumber | null
排名变化
04 · FIELDS

歌曲榜条目

ranknumber
榜单排名
trackIdstring
汽水歌曲 ID
titlestring
歌曲名
artistsstring[]
歌手列表
albumstring
专辑名
durationMsnumber
歌曲时长，毫秒
collected / comments / sharesnumber
收藏、评论、分享数
rankType / rankDeltastring / number
榜单趋势与变化值
mobileTop20boolean
是否位于手机端前 20 首
热门搜索展示规则

手机端固定显示 20 个位置。推广项会占用展示位，因此 displayCount 通常为 20，但 rankedCount 可能少于 20；请通过 kind 判断条目类型。