网易云音乐搜索

GETPOST 网易云

搜索网易云音乐歌曲,返回匹配的歌曲列表,包含歌曲名、歌手、专辑、封面、时长和 VIP 状态。支持分页。

GET https://api.tinyaii.cn/v1/netease/search

请求参数

参数名类型必填说明示例
keywordstring必填搜索关键词—
limitint可选返回数量,默认20,最大100—
offsetint可选偏移量,默认0—

返回字段

字段类型说明
keywordstring原始搜索关键词
totalint当前页返回的歌曲数量
songsarray搜索结果歌曲列表
songs[].idint歌曲 ID(可用于网易云音乐跳转或歌单解析)
songs[].namestring歌曲名称
songs[].singerstring歌手名称(多人用 / 分隔)
songs[].albumstring所属专辑名称
songs[].coverstring歌曲封面图片 URL
songs[].durationstring歌曲时长(格式:mm:ss)
songs[].freebool是否免费(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 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。