网易云音乐播放 API

搜索网易云音乐歌曲，获取歌词和播放地址，还有可以嵌入网页的播放器（仅支持免费歌曲外链播放）

数据来源：网易云音乐

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

搜索歌曲，返回播放地址和播放器链接

GET /api/music/search

请求参数

  • keyword（必填）：歌名、歌手或专辑名，示例 晴天 周杰伦
  • limit：每页条数（1~50），示例 5
  • page：页码，从 1 开始，示例 1

返回字段

  • keyword（string）：搜索关键词
  • page（number）：当前页码
  • total（number）：匹配的歌曲总数（上游 songCount）
  • songs（array）：本页歌曲
  • songs[].id（number）：歌曲 ID
  • songs[].name（string）：歌名
  • songs[].artists（array）：歌手名列表；上游缺失时为空数组
  • songs[].artists[]（string）：歌手名
  • songs[].album（string|null）：专辑名；上游缺失时为 null
  • songs[].cover（string|null）：专辑封面图链接（https）；上游缺失时为 null
  • songs[].durationMs（number|null）：时长（毫秒）；上游缺失时为 null
  • songs[].fee（number|null）：网易云收费类型（上游 fee）：0 / 8 免费，1 会员专享，4 付费专辑；上游缺失时为 null
  • songs[].playable（boolean|null）：能否通过外链播放：true 免费歌曲可以播放，false 会员或付费歌曲无法外链播放，null 无法判断
  • songs[].feeText（string）：收费类型的中文说明：免费 / 会员专享 / 付费专辑 / 未知
  • songs[].url（string）：网易云音乐歌曲页链接
  • songs[].playUrl（string）：网易云官方外链播放地址，打开后跳转到 MP3 文件，可放进 <audio src>（网易云的音频有防盗链，请同时加上 referrerpolicy="no-referrer"）；会员或付费歌曲无法播放
  • songs[].player（string）：本站播放器页面地址（带歌词滚动），可直接打开或用 <iframe> 嵌入网页

歌曲详情（含播放地址和播放器链接）

GET /api/music/song

请求参数

  • id（必填）：网易云音乐歌曲 ID（歌曲页网址 song?id= 后面的数字），示例 186016

返回字段

  • id（number）：歌曲 ID
  • name（string）：歌名
  • artists（array）：歌手名列表；上游缺失时为空数组
  • artists[]（string）：歌手名
  • album（string|null）：专辑名；上游缺失时为 null
  • cover（string|null）：专辑封面图链接（https）；上游缺失时为 null
  • durationMs（number|null）：时长（毫秒）；上游缺失时为 null
  • fee（number|null）：网易云收费类型（上游 fee）：0 / 8 免费，1 会员专享，4 付费专辑；上游缺失时为 null
  • playable（boolean|null）：能否通过外链播放：true 免费歌曲可以播放，false 会员或付费歌曲无法外链播放，null 无法判断
  • feeText（string）：收费类型的中文说明：免费 / 会员专享 / 付费专辑 / 未知
  • url（string）：网易云音乐歌曲页链接
  • playUrl（string）：网易云官方外链播放地址，打开后跳转到 MP3 文件，可放进 <audio src>（网易云的音频有防盗链，请同时加上 referrerpolicy="no-referrer"）；会员或付费歌曲无法播放
  • player（string）：本站播放器页面地址（带歌词滚动），可直接打开或用 <iframe> 嵌入网页

歌词（按时间逐行，含翻译）

GET /api/music/lyric

请求参数

  • id（必填）：网易云音乐歌曲 ID，示例 186016

返回字段

  • id（number）：歌曲 ID
  • instrumental（boolean）：是否为纯音乐（上游标记无歌词）
  • hasLyric（boolean）：是否有带时间的歌词
  • hasTranslation（boolean）：是否有翻译歌词（外文歌常见）
  • lines（array）：歌词行，按时间排序；空行（间奏）保留，text 为空字符串
  • lines[].time（number）：这一行开始的时间（毫秒）
  • lines[].text（string）：歌词文字
  • lines[].translation（string|null）：同一时间的翻译歌词；没有翻译时为 null
  • lrc（string|null）：原始 LRC 格式歌词，可直接交给播放器；没有歌词时为 null

播放地址（跳转到网易云官方外链）

GET /api/music/url

请求参数

  • id（必填）：网易云音乐歌曲 ID，示例 186016

网页播放器（带歌词滚动，可用 iframe 嵌入）

GET /api/music/player

请求参数

  • id：网易云音乐歌曲 ID；与 keyword 二选一，示例 186016
  • keyword：不知道 ID 时直接搜索，播放第一首可以外链播放的歌曲，示例 晴天 周杰伦
  • theme：配色：auto 跟随系统 / light 浅色 / dark 深色，示例 dark
  • autoplay：1 自动播放（浏览器可能要求用户先点击页面才允许有声音的自动播放），示例 0