网易云音乐搜索
搜索网易云音乐歌曲,返回匹配的歌曲列表,包含歌曲名、歌手、专辑、封面、时长和 VIP 状态。支持分页。
GET
https://api.tinyaii.cn/v1/netease/search
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| keyword | string | 必填 | 搜索关键词 | — |
| limit | int | 可选 | 返回数量,默认20,最大100 | — |
| offset | int | 可选 | 偏移量,默认0 | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| keyword | string | 原始搜索关键词 |
| total | int | 当前页返回的歌曲数量 |
| songs | array | 搜索结果歌曲列表 |
| 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": {
"keyword": "晴天",
"total": 20,
"songs": [
{
"id": 186016,
"name": "晴天",
"singer": "周杰伦",
"album": "叶惠美",
"cover": "http://p1.music.126.net/79-XFhWolhMzGESC8ifkg==/109951168569222280.jpg",
"duration": "4:29",
"free": false
},
{
"id": 2652820720,
"name": "晴天",
"singer": "Lucky小爱",
"album": "晴天(深情版)",
"cover": "http://p1.music.126.net/-79-XFhWolhMzGESC8ifkg==/109951170218252280.jpg",
"duration": "4:39",
"free": false
}
]
}
}
调用示例
curl "https://api.tinyaii.cn/v1/netease/search?keyword=<keyword>" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/netease/search?keyword=<keyword>", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/netease/search",
params={"keyword": "<keyword>"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。