网易云音乐榜单 API

获取网易云音乐官方榜单歌曲

GET /api/music/toplist

请求参数

• list：榜单：hot 热歌榜 / soaring 飙升榜 / new 新歌榜 / original 原创榜，示例 soaring
• limit：返回歌曲数（1~100），示例 10

返回字段

• list（string）：榜单参数，与请求参数 list 相同：hot / soaring / new / original
• id（number）：榜单在网易云音乐中的歌单 ID
• title（string）：榜单简称：热歌榜 / 飙升榜 / 新歌榜 / 原创榜
• name（string）：上游给出的榜单全名，如「云音乐热歌榜」；上游缺失时同 title
• updatedAt（string|null）：榜单更新时间（上游 updateTime），ISO 8601 格式，UTC 时区；上游未提供时为 null
• trackCount（number）：榜单歌曲总数（上游 trackCount；缺失时为实际解析到的歌曲数）
• tracks（array）：歌曲列表，按榜单排名排列，最多 limit 条（已跳过缺少 ID 或歌名的条目）
• tracks[].rank（number）：排名，从 1 开始连续编号
• tracks[].id（number）：歌曲 ID
• tracks[].name（string）：歌名
• tracks[].artists（array）：歌手名列表，多位歌手按上游顺序排列；上游缺失时为空数组
• tracks[].artists[]（string）：歌手名
• tracks[].album（string|null）：专辑名；上游缺失时为 null
• tracks[].durationMs（number|null）：歌曲时长（毫秒）；上游缺失时为 null
• tracks[].cover（string|null）：专辑封面图链接（https）；上游缺失时为 null
• tracks[].url（string）：网易云音乐歌曲页链接 https://music.163.com/#/song?id=歌曲ID
• tracks[].playUrl（string）：网易云官方外链播放地址，可直接放进 <audio src>；会员或付费歌曲无法播放