网易云音乐排行榜
获取网易云音乐排行榜。不传 id 返回所有榜单列表(62 个),传入榜单 id 返回该榜单前 100 首歌曲详情。
GET
https://api.tinyaii.cn/v1/netease/toplist
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 可选 | 榜单ID(不传返回榜单列表,传入返回该榜单歌曲) | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| lists | array | 榜单列表(不传 id 参数时返回此字段) |
| lists[].id | int | 榜单 ID(传给 id 参数可获取该榜单歌曲) |
| lists[].name | string | 榜单名称(如:飙升榜、新歌榜、热歌榜、原创榜) |
| lists[].update | string | 更新频率(如:刚刚更新、每天更新、每周四更新) |
| id | string | 当前查询的榜单 ID(传 id 参数时返回此字段) |
| songs | array | 歌曲列表(传 id 参数时返回此字段) |
| songs[].id | int | 歌曲 ID |
| songs[].name | string | 歌曲名称 |
| songs[].singer | string | 歌手名称(多人用 / 分隔) |
| songs[].album | string | 所属专辑名称 |
| songs[].cover | string | 歌曲封面图片 URL |
| songs[].duration | string | 歌曲时长(格式:mm:ss) |
| songs[].free | bool | 是否免费(true=可免费试听,false=需 VIP) |
返回示例
{
"code": 200,
"message": "success",
"data": {
"id": "19723756",
"songs": [
{
"id": 108640,
"name": "阴天",
"singer": "莫文蔚",
"album": "作品李宗盛",
"cover": "https://p2.music.126.net/DjFHDgJxYgByciKsCH3Tlg==/109951169614579889.jpg",
"duration": "4:02",
"free": false
},
{
"id": 2162282141,
"name": "晚风",
"singer": "7copy",
"album": "晚风",
"cover": "https://p1.music.126.net/SkRFIbJLqJxJQ==/109951168914864814.jpg",
"duration": "3:42",
"free": false
}
]
}
}
调用示例
curl "https://api.tinyaii.cn/v1/netease/toplist?id=<id>" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/netease/toplist?id=<id>", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/netease/toplist",
params={"id": "<id>"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。