📚 接口概述 🔍 搜索接口 🎵 选歌接口 🔥 热门歌曲 💬 评论接口 ⚠️ 错误响应

网易云音乐API文档

基于XieRen XR，提供丰富的音乐数据接口

API地址: http://qs.java.xrvi.top/wyyx

📚 接口概述

本API提供网易云音乐的数据接口，包括歌曲搜索、歌曲详情、歌词、热门评论等功能。所有接口均返回JSON格式数据。

接口地址: http://qs.java.xrvi.top/wyyx

主要功能

搜索歌曲 - 根据关键词搜索网易云音乐中的歌曲
歌曲详情 - 获取歌曲详细信息，包括歌词
热门歌曲 - 获取当前热门歌曲列表
歌曲评论 - 获取歌曲的热门评论

使用说明

所有接口均使用GET请求，参数通过URL查询字符串传递。成功响应返回code为200，错误时返回相应的错误码和错误信息。

GET ?action=search&keyword=关键词&limit=数量

搜索歌曲接口，根据关键词搜索网易云音乐中的歌曲。

请求参数

参数名	类型	必填	说明
action	string	是	固定值: search
keyword	string	是	搜索关键词，可以是歌曲名或歌手名
limit	integer	否	返回结果数量，默认10，最大100

请求示例

http://qs.java.xrvi.top/wyyx?action=search&keyword=周杰伦&limit=10

响应示例

{
  "code": 200,
  "message": "搜索成功",
  "data": {
    "search_info": {
      "keyword": "周杰伦",
      "limit": 10,
      "total": 10,
      "timestamp": 1634567890
    },
    "songs": [
      {
        "index": 1,
        "id": 123456,
        "name": "七里香",
        "artist": "周杰伦",
        "album": "七里香",
        "cover": "http://p3.music.126.net/xxx.jpg",
        "duration": 250000,
        "duration_formatted": "04:10",
        "play_url": "https://music.163.com/song/media/outer/url?id=123456",
        "is_paid": false,
        "fee_text": "免费歌曲"
      }
    ]
  }
}
                

GET ?action=select&song_id=歌曲ID&vip_parse=true&quality=音质

获取歌曲详细信息，包括歌曲详情、歌词。支持VIP歌曲解析功能

请求参数

参数名	类型	必填	说明
action	string	是	固定值: select
song_id	integer	是	歌曲ID
vip_parse	boolean	否	是否启用VIP解析，true/false，默认false
quality	string	否	音质选择: standard(标准), exhigh(极高), lossless(无损), hires(Hi-Res), 默认exhigh

请求示例

        
        http://qs.java.xrvi.top/wyyx?action=select&song_id=123456
        
        http://qs.java.xrvi.top/wyyx?action=select&song_id=123456&vip_parse=true&quality=lossless

响应示例（启用VIP解析时）

{
  "code": 200,
  "message": "获取歌曲信息成功",
  "data": {
    "song": {
      "id": 123456,
      "name": "七里香",
      "artists": [
        {
          "id": 6452,
          "name": "周杰伦"
        }
      ],
      "album": {
        "id": 12345,
        "name": "七里香",
        "cover": "http://p3.music.126.net/xxx.jpg"
      },
      "duration": 250000,
      "duration_formatted": "04:10",
      "play_url": "https://高质量VIP解析链接",
      "cover_url": "http://p3.music.126.net/xxx.jpg",
      "lyric": {
        "lrc": "[00:00.00]歌词内容...",
        "tlyric": "[00:00.00]Lyrics content...",
        "klyric": null
      },
      "is_paid": true,
      "fee_text": "付费歌曲",
      "vip_parse": {
        "enabled": true,
        "success": true,
        "quality": "lossless"
      }
    }
  }
}
    

VIP解析说明

功能特点：

支持解析VIP付费歌曲，获取完整版音频
提供多种音质选择，最高支持Hi-Res音质
VIP解析成功后，付费歌曲不会显示"试听版"字样

使用建议：

对于付费歌曲，建议启用VIP解析获取完整版
普通歌曲无需启用VIP解析，使用默认播放链接即可
根据网络情况选择合适的音质，无损音质文件较大

GET ?action=hot

获取热门歌曲列表。

请求参数

参数名	类型	必填	说明
action	string	是	固定值: hot

请求示例

http://qs.java.xrvi.top/wyyx?action=hot

响应示例

{
  "code": 200,
  "message": "获取热门歌曲成功",
  "data": {
    "hot_songs": [
      {
        "rank": 1,
        "id": 123456,
        "name": "热门歌曲",
        "artist": "歌手",
        "album": "专辑",
        "cover": "http://p3.music.126.net/xxx.jpg",
        "popularity": 100,
        "duration_formatted": "03:45",
        "is_paid": false,
        "fee_text": "免费歌曲"
      }
    ],
    "update_time": 1634567890
  }
}
                

GET ?action=comments&song_id=歌曲ID

获取歌曲的热门评论。固定返回最多15条热评

请求参数

参数名	类型	必填	说明
action	string	是	固定值: comments
song_id	integer	是	歌曲ID

请求示例

http://qs.java.xrvi.top/wyyx?action=comments&song_id=123456

响应示例

{
  "code": 200,
  "message": "获取热评成功",
  "data": {
    "song_id": 123456,
    "total": 1000,
    "hot_comments_count": 15,
    "hot_comments": [
      {
        "user_id": 1234567,
        "nickname": "用户昵称",
        "avatar_url": "http://p3.music.126.net/xxx.jpg",
        "content": "评论内容",
        "liked_count": 999,
        "time": "2023-10-20 12:34:56",
        "time_formatted": "2023年10月20日"
      }
    ]
  }
}
    

⚠️ 错误响应

所有接口在发生错误时都会返回统一的错误格式：

错误响应示例

{
  "code": 400,
  "message": "错误描述",
  "data": null
}
                

常见错误代码

错误码	说明
200	成功
400	请求参数错误
404	未找到资源
500	服务器内部错误