🎵 Music统一API接口文档

支持多平台音乐搜索、歌单、歌曲解析的统一接口

目前支持：酷狗(KG) | 酷我(KW) | QQ音乐(QQ) | 网易云(WY) | 咪咕(MG)
📋 基础信息

请求地址：https://demoapi.nxinxz.com/api.php

请求方法：GET / POST

响应格式：JSON

编码：UTF-8

🎯 功能特色
  • ✅ 支持多音质获取（标准/高品质/无损/Hi-Res）
  • ✅ 支持歌词解析
  • ✅ 支持歌单批量获取
  • ✅ 支持搜索功能
  • ✅ 自动换源保证可用性
  • ✅ 统一接口规范

🚀 快速开始

搜索歌曲示例：
https://demoapi.nxinxz.com/?kw&name=稻香&page=1&limit=10

获取歌曲信息示例：
https://demoapi.nxinxz.com/kw.php?id=76323299&level=lossless&type=json&all_quality=1

获取歌单示例：
https://demoapi.nxinxz.com/kwlist.php?id=3528940505&page=1&limit=30

🎵 歌曲解析接口

根据歌曲ID获取详细信息和播放链接

通用参数：
参数名 类型 必填 说明
id string 是 歌曲ID
level string 否 音质等级
type string 否 返回类型
all_quality bool 否 获取所有音质
音质等级说明：
值 说明
standard标准音质MP3
exhigh极高音质MP3
m4a高品质M4A
lossless无损音质
hiresHi-Res音质
返回类型说明：
值 说明
jsonJSON格式详细信息
mp3直接重定向到音频链接
pic重定向到封面图片
lrc返回歌词信息
请求示例：
酷狗：https://demoapi.nxinxz.com/kgandkw.php?id=666484E904A54B1E62C9FBFDBE6E2563&level=lossless&type=json
酷我：https://demoapi.nxinxz.com/kw.php?id=76323299&level=exhigh&type=json&all_quality=1
QQ音乐：https://demoapi.nxinxz.com/qqandkw.php?id=0039MnYb0qxYhV&level=lossless&type=json
网易云：https://demoapi.nxinxz.com/wy.php?id=1901371647&level=hires&type=json
咪咕：https://demoapi.nxinxz.com/mg.php?id=6902739Z004&level=exhigh&type=json

酷我歌词（数组对象格式）：
https://demoapi.nxinxz.com/kw.php?id=76323299&only_lrc=1
酷我歌词（原始lrc字符串格式）：
https://demoapi.nxinxz.com/kw.php?id=76323299&only_lrc=1&format=lrcstr

📋 歌单接口

获取各平台歌单详情和歌曲列表

请求参数：
参数名 类型 必填 说明 示例值
id string 是 歌单ID 7789509669
page int 否 页码，默认1 1
limit int 否 每页数量，默认30 30
详细调用示例：
酷我歌单：
https://demoapi.nxinxz.com/kwlist.php?id=3528940505&page=1&limit=30

网易歌单：
https://demoapi.nxinxz.com/wylist.php?id=13073225087&limit=30

酷狗歌单(酷狗码)：
https://demoapi.nxinxz.com/kglist.php?id=2559999&page=1&limit=30

酷狗歌单(collection_id)：
https://demoapi.nxinxz.com/kglist.php?id=collection_3_1863870844_4_0&page=1&limit=30

酷狗歌单(分享链接)：
https://demoapi.nxinxz.com/kglist.php?id=https://t1.kugou.com/cvD73c2CRV2&page=1&limit=30

QQ歌单：
https://demoapi.nxinxz.com/qqlist.php?id=7789509669&limit=30

咪咕歌单：
https://demoapi.nxinxz.com/mglist.php?id=225068708&page=0&limit=30
📝 酷狗歌单ID说明：
  • 酷狗码：数字形式的ID，如 2559999
  • Collection ID：以 collection_ 开头的完整ID
  • 分享链接：酷狗概念版的分享链接，系统会自动解析

🏷️ 分类接口

获取音乐平台的分类信息和分类下的歌单列表（目前仅支持酷我平台）

📝 功能说明
  • 获取全部分类：获取平台所有分类列表
  • 分类歌单列表：获取指定分类下的歌单
  • 推荐歌单：获取平台推荐的精选/最热歌单
1. 获取全部分类
参数名 类型 必填 说明 示例值
type string 是 固定值 getTagList getTagList
order string 是 固定值 Tag Tag
2. 获取分类歌单
参数名 类型 必填 说明 示例值
type string 是 固定值 getTagList getTagList
id string 是 分类ID 2189
page int 否 页码，默认1 1
limit int 否 每页数量，默认30 30
3. 推荐歌单
参数名 类型 必填 说明 示例值
name string 是 推荐类型：精选/最热 精选
page int 否 页码，默认1 1
limit int 否 每页数量，默认30 30
请求示例：
获取全部分类：
https://demoapi.nxinxz.com/rcmlist.php?type=getTagList&order=Tag

获取抖音分类歌单：
https://demoapi.nxinxz.com/rcmlist.php?type=getTagList&id=2189&page=1&limit=30

获取精选推荐歌单：
https://demoapi.nxinxz.com/rcmlist.php?name=精选&page=1&limit=30
https://demoapi.nxinxz.com/category-parser.php?name=精选&page=1&limit=30

获取最热推荐歌单：
https://demoapi.nxinxz.com/rcmlist.php?name=最热&page=1&limit=30
https://demoapi.nxinxz.com/category-parser.php?name=最热&page=1&limit=30

获取酷我排行榜：
https://demoapi.nxinxz.com/category-parser.php?type=getLeaderboardDetail&id=16&page=1&limit=50
https://demoapi.nxinxz.com/category-parser.php?type=getLeaderboards
📝 接口说明
  • 主接口：rcmlist.php - 完整功能的推荐和分类接口
  • 备用接口：category-parser.php - 分类解析专用接口，也支持推荐歌单
  • 推荐歌单参数：name=精选|最热, page=页码, limit=数量

🔗 统一接口规范

推荐使用统一接口格式，更加规范和易用

⚠️ 统一接口说明

统一接口通过 platform 和 action 参数来区分不同的平台和操作，使API调用更加规范。

搜索统一接口：
基础格式：https://demoapi.nxinxz.com/api.php?platform={平台}&action=search&name={关键词}&page={页码}&limit={数量}

酷我搜索：https://demoapi.nxinxz.com/api.php?platform=kw&action=search&name=稻香&page=1&limit=20
网易搜索：https://demoapi.nxinxz.com/api.php?platform=wy&action=search&name=青花瓷&page=1&limit=20
QQ搜索：https://demoapi.nxinxz.com/api.php?platform=qq&action=search&name=告白气球&page=1&limit=20
酷狗搜索：https://demoapi.nxinxz.com/api.php?platform=kg&action=search&name=夜曲&page=1&limit=20
咪咕搜索：https://demoapi.nxinxz.com/api.php?platform=mg&action=search&name=七里香&page=1&limit=20
歌单统一接口：
基础格式：https://demoapi.nxinxz.com/api.php?platform={平台}&action=playlist&id={歌单ID}&page={页码}&limit={数量}

酷我歌单：https://demoapi.nxinxz.com/api.php?platform=kw&action=playlist&id=3528940505&page=1&limit=30
网易歌单：https://demoapi.nxinxz.com/api.php?platform=wy&action=playlist&id=13073225087&limit=30
酷狗歌单(酷狗码)：https://demoapi.nxinxz.com/api.php?platform=kg&action=playlist&id=2559999&page=1&limit=30
酷狗歌单(collection_id)：https://demoapi.nxinxz.com/api.php?platform=kg&action=playlist&id=collection_3_1863870844_4_0&page=1&limit=30
酷狗歌单(分享链接)：https://demoapi.nxinxz.com/api.php?platform=kg&action=playlist&id=https://t1.kugou.com/cvD73c2CRV2&page=1&limit=30
QQ歌单：https://demoapi.nxinxz.com/api.php?platform=qq&action=playlist&id=7789509669&limit=30
咪咕歌单：https://demoapi.nxinxz.com/api.php?platform=mg&action=playlist&id=225068708&page=1&limit=30
歌曲解析统一接口：
基础格式：https://demoapi.nxinxz.com/api.php?platform={平台}&action=song&id={歌曲ID}&level={音质}&type={类型}&all_quality={是否获取所有音质}

酷我歌曲：https://demoapi.nxinxz.com/api.php?platform=kw&action=song&id=76323299&level=lossless&type=json&all_quality=1
网易歌曲：https://demoapi.nxinxz.com/api.php?platform=wy&action=song&id=1901371647&level=hires&type=json&all_quality=1
QQ歌曲：https://demoapi.nxinxz.com/api.php?platform=qq&action=song&id=0039MnYb0qxYhV&level=lossless&type=json&all_quality=1
酷狗歌曲：https://demoapi.nxinxz.com/api.php?platform=kg&action=song&id=666484E904A54B1E62C9FBFDBE6E2563&level=lossless&type=json&all_quality=1
咪咕歌曲：https://demoapi.nxinxz.com/api.php?platform=mg&action=song&id=6902739Z004&level=exhigh&type=json
酷我歌词（数组对象格式）：
https://demoapi.nxinxz.com/api.php?platform=kw&action=song&id=76323299&only_lrc=1
酷我歌词（原始lrc字符串格式）：
https://demoapi.nxinxz.com/api.php?platform=kw&action=song&id=76323299&only_lrc=1&format=lrcstr
推荐歌单统一接口：
基础格式：https://demoapi.nxinxz.com/api.php?platform=kw&action=rcmlist&name={类型}&page={页码}&limit={数量}

酷我推荐歌单（精选）：https://demoapi.nxinxz.com/api.php?platform=kw&action=rcmlist&name=精选&page=1&limit=30
酷我推荐歌单（最热）：https://demoapi.nxinxz.com/api.php?platform=kw&action=rcmlist&name=最热&page=1&limit=30
分类解析统一接口：
酷我获取全部分类：https://demoapi.nxinxz.com/api.php?platform=kw&action=category&type=getTagList&order=Tag
酷我获取分类歌单：https://demoapi.nxinxz.com/api.php?platform=kw&action=category&type=getTagLists&id=2189&page=1&limit=30
酷我获取排行榜列表：https://demoapi.nxinxz.com/api.php?platform=kw&action=category&type=getLeaderboards
酷我获取排行榜详情：https://demoapi.nxinxz.com/api.php?platform=kw&action=category&type=getLeaderboardDetail&id=93&page=1&limit=100

网易获取分类歌单：https://demoapi.nxinxz.com/api.php?platform=wy&action=category&type=getCategoryList&cat=华语&page=1&limit=30
网易获取排行榜列表：https://demoapi.nxinxz.com/api.php?platform=wy&action=category&type=getLeaderboards
网易获取排行榜详情：https://demoapi.nxinxz.com/api.php?platform=wy&action=category&type=getLeaderboardDetail&id=19723756&page=1&limit=50
网易搜索歌单：https://demoapi.nxinxz.com/api.php?platform=wy&action=category&type=searchPlaylists&keywords=流行&page=1&limit=30
平台标识说明：
平台 标识 说明
酷我音乐kwKuWo Music
网易云音乐wyWangYi Music
QQ音乐qqQQ Music
酷狗音乐kgKuGou Music
咪咕音乐mgMiGu Music
操作类型说明：
操作 标识 说明
搜索search搜索歌曲
歌单playlist获取歌单信息
歌曲song获取歌曲详情和播放链接
推荐歌单rcmlist获取推荐歌单
分类解析category获取分类信息和分类歌单

📤 响应格式

歌曲解析响应示例：
{
  "code": 200,
  "msg": "解析成功",
  "data": {
    "rid": "歌曲ID",
    "name": "歌曲名",
    "artist": "艺术家",
    "album": "专辑名",
    "pic": "封面图片URL",
    "url": "播放链接",
    "lrc": "歌词内容",
    "quality": [
      {
        "size": "文件大小",
        "quality": "音质描述",
        "level": "音质等级",
        "url": "播放链接"
      }
    ]
  }
}
搜索响应示例：
{
  "code": 200,
  "msg": "搜索成功",
  "data": [
    {
      "rid": "歌曲ID",
      "name": "歌曲名",
      "artist": "艺术家",
      "album": "专辑名",
      "pic": "封面图片URL",
      "duration": "时长"
    }
  ]
}
歌单响应示例：
{
  "code": 200,
  "msg": "获取歌单成功",
  "data": {
    "name": "歌单名称",
    "img": "歌单封面",
    "id": "歌单ID",
    "musicList": [
      {
        "rid": "歌曲ID",
        "name": "歌曲名",
        "artist": "艺术家",
        "pic": "封面图片URL"
      }
    ]
  }
}
状态码说明：
状态码 说明
200请求成功
400参数错误
500服务器错误

⚠️ 注意事项

📝 更新日志

v2.2.0 - 2024年最新版
  • ✅ 新增分类解析功能
  • ✅ 支持获取全部歌单分类
  • ✅ 支持获取分类下的歌单列表
  • ✅ 整合分类功能到统一接口
  • ✅ 完善API文档说明
  • ✅ 新增统一接口规范
  • ✅ 完善歌单接口文档
  • ✅ 新增多音质并发获取功能
  • ✅ 优化酷我换源算法
  • ✅ 增强错误处理机制

Powered by 念心 | QQ: 1185317337 | 仅供学习交流使用，请遵守相关法律法规