QQ音乐全能解析API接口使用指南
本接口提供QQ音乐全链路解析服务，支持单曲信息、歌词、歌单、音乐搜索、MV信息等多种功能，帮助开发者快速集成QQ音乐数据服务。
接口地址：
https://www.phpks.com/api/qqmusic/v2
接口功能概览
- 单曲解析 - 获取歌曲详细信息
- 歌词获取 - 支持LRC格式歌词
- 歌单解析 - 解析QQ音乐歌单内容
- 音乐搜索 - 支持关键词搜索音乐
- MV信息 - 获取MV详情及下载链接
- 排行榜 - 获取各类音乐榜单
- 专辑图片 - 获取高清专辑封面
- 热搜列表 - 获取QQ音乐热搜榜
- 新歌首发 - 获取最新发布的歌曲
- 云搜索 - 综合搜索单曲/专辑/歌手/MV/用户
请求参数说明
| 参数名 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35k[5]n[5]3453k[5]43n[5] | 接口密钥，在控制台->密钥管理查看 |
| type | 是 | string | song | 解析类型：song(单曲)、songlist(歌单)、so(搜索)、url(试听链接)、pic(专辑图)、lrc(歌词)、mv(MV信息)、topgroup(排行榜分组)、toplist(排行榜歌曲列表)、keytop(热搜列表)、new_songlist(新歌首发)、spicloud(云搜索分组) |
| id | 否 | string | 765163652 | 歌单ID，type=songlist时必填 |
| mid | 否 | string | dawd1ad141d | 歌曲mid，type=song/url/pic/lrc时必填 |
| word | 否 | string | 周杰伦 | 搜索关键词(type=so/spicloud时必填)，需urlencode编码 |
| per_page | 否 | int | 10 | 搜索结果数量(type=so时有效)，默认10 |
| page | 否 | int | 1 | 搜索页数(type=so时有效)，需配合per_page使用，默认1 |
| size | 否 | string | mp3 | 音质选择(type=url时有效)：mp3(普通)、hq(高品质)、sq(无损)、hires(HiRes) |
| media_mid | 否 | string | dawd1ad141d | 歌曲media_mid(type=url时备用)，留空默认使用mid |
| format | 否 | string | json | 输出格式(type=url/pic/lrc时有效)，留空默认302重定向 |
| cookie | 否 | string | 无 | 下载VIP音乐需要，base64加密的QQ音乐cookie(qm_keyst和uin) |
| vid | 否 | string | dawd1ad141d | MV的vid(type=mv时必填) |
| topid | 否 | string | 2121 | 排行榜ID(type=toplist时必填) |
| period | 否 | string | 2023 | 排行榜时期(type=toplist时必填) |
| listmax | 否 | int | 100 | 返回结果最大数量(type=so/toplist/songlist时有效) |
接口调用示例
1. 获取单曲信息
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=song&mid=0042QMDR1VzSx2. 解析歌单
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=songlist&id=7651636523. 搜索音乐
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=so&word=周杰伦&per_page=5&page=14. 获取试听链接(HQ音质)
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=url&mid=0042QMDR1VzSx&size=hq5. 获取VIP音乐(需cookie)
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=url&mid=0042QMDR1VzSx&size=sq&cookie=base64加密的cookie6. 获取排行榜歌曲
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=toplist&topid=4&period=20237. 获取热搜列表
https://www.phpks.com/api/qqmusic/v2?key=YOUR_KEY&type=keytop注意事项
- VIP音乐下载：需要提供有效的base64加密cookie信息(qm_keyst和uin)
- 搜索关键词：必须进行urlencode编码
- 音质选择：普通用户只能获取普通音质(mp3/m4a)，VIP用户可获取高品质(hq/sq/hires)
- 输出格式：url/pic/lrc类型默认返回302重定向，设置format=json可获取JSON数据
- 请求频率：请合理控制请求频率，避免服务器压力过大
常见问题
- 登录QQ音乐官网(y.qq.com)
- 打开浏览器开发者工具(F12)
- 在Network标签中找到任意请求，复制Cookie中的
qm_keyst和uin值 - 格式化为
qm_keyst=你的值; uin=你的QQ号 - 使用base64加密整个字符串
- 将加密结果作为cookie参数传入
获取歌曲mid：
- 使用搜索API(type=so)搜索歌曲
- 从返回结果中获取歌曲的mid字段
获取歌单id：
- 在QQ音乐客户端或网页版打开歌单
- 从URL中获取id参数，如：...id=123456中的123456
获取MV vid：
- 使用单曲API(type=song)获取歌曲信息
- 从mv字段中获取vid
- 或从搜索API(type=so)结果中获取mv.vid
这是API的默认行为，如需直接获取JSON数据，请添加&format=json参数。
302重定向适用于直接获取资源(如音乐文件、图片等)的场景，而JSON格式适用于需要处理元数据的场景。
更多详细文档请访问 API文档中心 或联系技术支持。
