YMhut-box-C-/third_party/MoeKoeMusic/api/docs/README.md

KuGouMusic API

酷狗音乐 NodeJS 版 API

环境要求

需要 NodeJS 12+ 环境

工作原理

跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API

功能特性

1. 登录
2. 刷新登录
3. 发送验证码
4. dfid 获取
5. 获取用户额外信息
6. 获取用户 vip 信息
7. 获取用户歌单
8. 获取用户云盘
9. 获取用户云盘音乐 URL
10. 获取用户收藏的视频
11. 获取用户喜欢的视频
12. 获取用户关注歌手
13. 获取用户听歌历史排行
14. 获取用户最近听歌历史
15. 获取继续播放信息（对应手机版首页显示继续播放入口）
16. 收藏歌单/新建歌单
17. 取消收藏歌单/删除歌单
18. 对歌单添加歌曲
19. 对歌单删除歌曲
20. 新碟上架
21. 专辑信息
22. 专辑详情
23. 专辑音乐列表
24. 获取音乐 URL
25. 获取音乐 URL（新版）
26. 获取歌曲高潮部分
27. 搜索
28. 默认搜索关键词
29. 综合搜索
30. 热搜列表
31. 搜索建议
32. 歌词搜索
33. 获取歌词
34. 歌单分类
35. 歌单
36. 主题歌单
37. 音效歌单
38. 获取歌单详情
39. 获取歌单所有歌曲
40. 获取歌单所有歌曲（新版）
41. 相似歌单
42. 获取主题歌单所有歌曲
43. 获取主题音乐
44. 获取主题音乐详情
45. 歌曲推荐
46. 获取歌手和专辑图片
47. 获取歌手图片
48. 获取音乐相关信息
49. 获取更多音乐版本
50. 获取音乐伴奏信息
51. 获取音乐k歌数量
52. 获取音乐详情
53. 获取音乐专辑/歌手信息
54. 私人 FM(对应手机和 pc 端的猜你喜欢)
55. banner
56. 乐库 banner
57. 乐库电台
58. 乐库
59. 电台 - 推荐
60. 电台
61. 电台 - 图片
62. 电台 - 音乐列表
63. 编辑精选
64. 编辑精选数据
65. 编辑精选歌单
66. 编辑精选专区
67. 编辑精选专区详情
68. 领取 VIP（需要登陆，该接口为测试接口，仅限概念版使用）
69. 领取一天 VIP（需要登陆，该接口为测试接口，仅限概念版使用）
70. 获取当月已领取 VIP 天数（需要登陆，该接口为测试接口，仅限概念版使用）
71. 获取已领取 VIP 状态（需要登陆，该接口为测试接口，仅限概念版使用）
72. 获取歌手列表
73. 获取歌手详情
74. 获取歌手专辑
75. 获取歌手单曲
76. 获取歌手 MV
77. 关注歌手
78. 取消关注歌手
79. 获取关注歌手新歌
80. 获取视频 url
81. 获取歌曲 MV
82. 获取视频相关信息
83. 获取视频详情
84. 新歌速递
85. 场景音乐列表
86. 场景音乐详情
87. 获取场景音乐讨论区
88. 获取场景音乐模块 Tag
89. 获取场景音乐歌单列表
90. 获取场景音乐视频列表
91. 获取场景音乐音乐列表
92. 每日推荐
93. 历史推荐
94. 风格推荐
95. 排行列表
96. 排行榜推荐列表
97. 排行榜往期列表
98. 排行榜信息
99. 排行榜歌曲列表
100. 歌曲收藏数
101. 歌曲评论数
102. 歌曲评论
103. 歌曲评论-根据分类返回
104. 歌曲评论-根据热词返回
105. 楼层评论
106. 歌单评论
107. 专辑评论
108. 提交听歌历史
109. 获取服务器时间
110. 刷刷
111. AI 推荐
112. 曲谱 - 获取歌曲曲谱
113. 曲谱 - 曲谱排行榜
114. 曲谱 - 曲谱详情
115. 曲谱 - 曲谱广场
116. 曲谱 - 曲谱标签
117. 频道 - 获取用户所有频道
118. 频道 - 详情
119. 频道 - 频道安利
120. 频道 - 相似频道
121. 频道 - 订阅
122. 频道 - 音乐故事
123. 频道 - 音乐故事详情
124. 动态 - 最常访问
125. 获取用户公开的音乐
126. 听书 - 每日推荐
127. 听书 - 排行榜推荐
128. 听书 - VIP 推荐
129. 听书 - 每周推荐
130. 听书 - 专辑详情
131. 听书 - 专辑音乐列表
132. 歌曲详情 - 歌曲成绩单
133. 歌曲详情 - 歌曲成绩单详情
134. 听歌识曲
135. 获取已购单曲
136. 获取已购专辑
137. 上传音乐到云盘

安装

$ git clone git@github.com:MakcRe/KuGouMusicApi.git
$ cd KuGouMusicApi
$ npm install

使用接口为概念版

$ 复制 .env.example 为 .env，并且把里面的 `platform=''` 改为 `platform=lite`
$ 注意不同版本的平台的 token 是不通用的。

运行

$ npm run dev

服务器启动默认端口为 3000, 若不想使用 3000 端口 , 可使用以下命令 : Mac/Linux

$ PORT=4000 npm run dev

windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :

$ set PORT=4000 && npm run dev

windows 下使用 PowerShell 终端执行一下命令 :

$ $Env:PORT=4000; npm run dev

服务器启动默认 host 为 localhost,如果需要更改, 可使用以下命令 : Mac/Linux

$ HOST=127.0.0.1 npm run dev

windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :

$ set HOST=127.0.0.1 && npm run dev

免责声明

!> 1. 本项目仅供学习使用，请尊重版权，请勿利用此项目从事商业行为及非法用途!

!> 2. 使用本项目的过程中可能会产生版权数据。对于这些版权数据，本项目不拥有它们的所有权。为了避免侵权，使用者务必在 24 小时内清除使用本项目的过程中所产 生的版权数据。

!> 3. 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停 工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责。

!> 4. 禁止在违反当地法律法规的情况下使用本项目。 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担， 本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

!> 5. 音乐平台不易，请尊重版权，支持正版。

!> 6. 本项目仅用于对技术可行性的探索及研究，不接受任何商业（包括但不限于广告等）合作及捐赠。

!> 7. 如果官方音乐平台觉得本项目不妥，可联系本项目更改或移除。

Vercel 部署

操作方法

1. fork 此项目
2. 在 Vercel 官网点击 New Project
3. 点击 Import Git Repository 并选择你 fork 的此项目并点击 import
4. 点击 PERSONAL ACCOUNT 的 select
5. 直接点 Continue
6. 若需要部署版本为概念版（不需要该步骤可以跳过），在 Environment Variables 添加 key 为 platform，Value (Will Be Encrypted) 为 lite 然后点击 Add
7. PROJECT NAME自己填,FRAMEWORK PRESET 选 Other 然后直接点 Deploy 接着等部署完成即可

接口文档

调用前须知

!> 本项目不提供线上 demo，请不要轻易信任使用他人提供的公开服务，以免发生安全问题,泄露自己的账号和密码

!> 为使用方便,降低门槛, 文档示例接口直接使用了 GET 请求,本项目同时支持 GET/POST 请按实际需求使用 (POST 请求 url 必须添加时间戳,使每次请求 url 不一样, 不然请求会被缓存)

!> 由于接口做了缓存处理 ( 缓存 2 分钟,), 相同的 url 会在两分钟内只向酷狗服务器发一次请求 , 如果遇到不需要缓 存结果的接口 , 可在请求 url 后面加一个时间 戳参数使 url 不同 , 例子 : /personal/fm?timestamp=1691256061923 (请按自己需求改造缓存中间件(app.js)，源码不复杂) 该缓存机制来源 于Binaryify/NeteaseCloudMusicApi

!> 不要频繁调登录接口,不然可能会被风控,登录状态还存在就不要重复调登录接口

!> 如果是跨域请求 , 请在所有请求带上 xhrFields: { withCredentials: true } (axios 为 withCredentials: true, Fetch API 为 fetch(url, { credentials: 'include' })), 或直接手动传入 cookie。

!> 本项目仅供学习使用,请尊重版权，请勿利用此项目从事商业行为或进行破坏版权行为

!> 文档可能会有缓存 , 如果文档版本和 github 上的版本不一致,请清除缓存再查看

更新记录

26-08-01：添加 上传音乐到云盘、删除用户云盘音乐 接口

26-05-20：更新曲谱相关接口

25-08-17: 手机登录添加支持多用户登录

25-04-05: 添加 用户云盘，用户云盘 url, 获取用户收藏视频，获取用户喜欢视频 等接口

25-03-28：添加 领取一天 VIP, 获取当月已领取 VIP 天数, 领取一天 VIP,获取已领取 VIP 状态,获取音乐 URL（新版） 等接口

25-03-07：更新单曲搜索接口，更新歌词搜索接口。

25-01-16：添加 获取继续播放信息 接口，修复部分老歌在概念版无法获取问题

25-01-11：添加 关注歌手 取消关注歌手 获取关注歌手新歌 接口

24-08-09：添加 获取更多音乐版本 接口。

24-07-22：添加 歌曲详情 接口.

24-07-17: 添加 搜索建议 接口。

24-07-14: 添加 频道、听书等多个接口。

24-07-14: 添加 刷刷、AI 推荐 接口，更新 提交听歌历史 接口。

24-06-30: 添加 获取歌手列表 接口

24-06-25: 添加 默认搜索关键词、获取歌曲 MV、提交听歌历史等接口

24-05-30: 添加曲谱接口

24-05-19: 修复设备平台判断问题，添加 获取用户关注歌手 接口

24-05-14: 添加 楼层评论、歌单评论、专辑评论、热搜列表接口。修复 歌单 接口

24-05-14: 添加 歌曲评论、歌曲评论-根据分类返回、歌曲评论-根据热词返回 接口

24-05-12: 添加支持酷狗概念版登录

24-05-07: 修复热门歌单接口

24-01-17: 添加：排行榜列表接口、排行榜推荐列表接口、排行榜往期列表接口、排行榜信息接口、排行榜歌曲列表接口

24-01-12: 更新私人 FM 接口

24-01-07: 添加 每日推荐、历史推荐、 风格推荐 API 接口

23-12-19: 添加场景音乐相关接口

23-12-18: 添加 收藏歌单，取消收藏歌单，对歌单添加歌曲，对歌单删除歌曲 接口

23-11-10: 添加歌手相关 API、添加视频相关 API

23-10-01: 添加领取 vip 接口

23-08-27: 更新音乐 url 获取

23-08-11: 添加电台 api

23-08-06: 添加缓存机制

23-07-19: 更新酷狗二维码登录

23-06-29: 添加 新歌速递、乐库等多个接口

23-06-28: 添加获取歌手图片接口

23-06-25: 添加 每日主题音乐 获取每日主题音乐详情 歌单 等接口

23-06-23: 修复搜索接口

23-06-23: 添加 搜索、获取歌词等接口

23-06-23: 添加 获取音乐 URL 接口

23-06-23: 更新文档

23-06-23: 添加每日歌曲推荐、专辑详情、专辑音乐列表、新碟上架

23-06-22: 添加支持微信登录、开放接口登录

23-06-22: 添加支持 vercel

23-06-22: 密码登录、验证码登录、扫码登录

登录

说明：登录有五个接口使用 encodeURIComponent对密码编码或者使用 POST请求，避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

不要频繁调登录接口,不然可能会被风控,登录状态还存在就不要重复调登录接口, 不同版本的 token 是不通用的

1.手机登录

必选参数：

mobile: 手机号码

code: 验证码，使用 /captcha/sent接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录

可选参数

userid: 用户 id,当用户存在多个账户是时，必须加上需要登录的用户 id

接口地址： /login/cellphone

调用例子： /login/cellphone?mobile=xxx&code=xxx

2. 用户名登录(该登录可能需要验证，不推荐使用)

必选参数：

username: 用户名

password: 密码

接口地址： /login

调用例子： /login?username=xxx&password=yyy

3. 开放接口登录(目前仅支持微信登录)

说明: 该接口为第三方平台登录，目前仅支持微信登录

必选参数：

code: 由微信扫码成功后生成

接口地址： /login/openplat

调用例子： /login/openplat?code=xxx

4. 二维码登录

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1.二维码 key 生成接口

说明: 调用此接口可生成一个 key

接口地址： /login/qr/key

2.二维码生成接口

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成 库渲染二维码

必选参数：

key: ,由第一个接口生成

可选参数：

qrimg: 传入后会额外返回二维码图片 base64 编码

接口地址： /login/qr/create

调用例子： /login/qr/create?key=xxx

2.二维码检测扫码状态接口

说明: 轮询此接口可获取二维码扫码状态,0 为二维码过期，1 为等待扫码，2 为待确认，4 为授权登录成功（4 状态码下会返回 token）

必选参数：

key: ,由第一个接口生成

接口地址： /login/qr/check

调用例子： /login/qr/check?key=xxx

5. 微信登录

说明：微信登录涉及到 2 个接口,调用务必带上时间戳,防止缓存

1. 二维码生成接口

说明：调用此接口可生成微信的 uuid, 包括二维码 Bae64 和 二维码扫描链接, 注: 该接口请求的接口过多, 会出现返回较慢的情况

接口地址： /login/wx/create

调用例子： /login/wx/create

2.二维码检测扫码状态接口

说明：轮询此接口可获取二维码扫码状态, 408 为等待扫描，404 为已经扫描，403 为拒绝登录，405 为登录成功，402 为已过期(405 状态下登陆完成口会返回 wx_code, 用于开放登陆 /login/openplat), 注：该接口有一定延时，不可访问是可以直接到 https://long.open.weixin.qq.com/connect/l/qrconnect?f=json&uuid=xxx 该接口直接请求

必选参数：

uuid: 由第一个接口生成

可选参数：

timestamp: 建议传递，否则由于缓存会导致延迟

接口地址： /login/wx/check

调用例子： /login/wx/check?timestamp=1691256061923&uuid=xxxxxxxxx

刷新登录

说明 : 调用此接口，可刷新登录状态，可以延长 token 过期时间

可选参数：

token: 登录后获取的 token

userid: 用户 id

接口地址： /login/token

调用例子： /login/token /login/token?token=xxx&userid=xxx

发送验证码

说明: 调用此接口 ,传入手机号码, 可发送验证码

必选参数：

mobile: 手机号码

接口地址： /captcha/sent

调用例子： /captcha/sent?mobile=xxx

dfid 获取

接口地址： /register/dev

调用例子： /register/dev

获取用户额外信息

说明：登陆后调用此接口，可以获取用户额外信息

接口地址： /user/detail

获取用户 vip 信息

说明：登陆后调用此接口，可以获取用户 vip 信息

接口地址： /user/vip/detail

获取用户歌单

说明：登录后调用此接口，可以获取用户的所有创建以及收藏的歌单

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /user/playlist

调用例子： /user/playlist

获取用户关注歌手

说明：登录后调用此接口，可以获取用户的所有关注的歌手/用户

接口地址： /user/follow

调用例子： /user/follow

获取关注歌手消息

说明：登录后调用此接口，可以关注的歌手/用户消息

id: 需要获取歌手/用户消息的 userid

pagesize : 每页页数, 默认为 30

接口地址： /user/follow/message

调用例子： /user/follow/message

获取用户云盘

说明：登录后调用此接口可以获取用户上传到云盘的音乐（需要登录）

可选参数

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /user/cloud

调用例子： /user/cloud

获取用户云盘音乐 URL

说明：登录后调用此接口可以获取用户上传到云盘的音乐 URL，部分可以直接用 /song/url 直接获取 URL（需要登录，目前获取到的文件大小都约为 10M 左右）

必选参数：

hash: 音乐 hash

可选参数：

album_id: 专辑 id

name: 云盘音乐名称

album_audio_id：专辑音频 id

接口地址： /user/cloud/url

调用例子： /user/cloud/url

删除用户云盘音乐

说明：登录后调用此接口可以删除用户云盘中的音乐（需要登录）

必选参数：

fileid: 云盘文件 ID（列表接口返回的 kv_id），多个可用逗号分隔；也可使用 fileids 传数组

可选参数：

clientver: 覆盖客户端版本号，默认使用当前平台配置

appid: 覆盖 appid，默认使用当前平台配置

kv_id: fileid 别名

album_audio_id: 专辑音频 ID（列表接口返回的 album_audio_id），多个可用逗号分隔；也可使用 album_audio_ids 传数组

接口地址： /user/cloud/del

调用例子： /user/cloud/del?fileid=1&album_audio_id=123

云盘上传前曲库匹配

说明：登录后调用此接口可以根据文件 hash 匹配曲库信息，用于上传前获取 hash_std、audio_id、album_audio_id

必选参数：

hash: 文件 hash（即文件 MD5），多个可用逗号分隔；也可通过请求体传入文件二进制数据自动计算

可选参数：

album_audio_id: 专辑音频 ID，已有时可辅助匹配，多个可用逗号分隔；也可使用 album_audio_ids 传数组

clientver: 覆盖客户端版本号，默认使用当前平台配置

appid: 覆盖 appid，默认使用当前平台配置

接口地址： /user/cloud/match

调用例子： /user/cloud/match?hash=e1fe087ba28766b8c95239487a0e46dc

上传音乐到云盘

说明：登录后调用此接口可以将音乐文件上传到用户云盘，需通过请求体传入文件二进制数据（Content-Type: application/octet-stream）
默认会先根据文件 hash 调用曲库匹配接口，并将匹配到的 hash_std、audio_id、album_audio_id 写入云盘；手动传入这些参数时会优先使用手动值

必选参数：

无

可选参数：

filename: 文件 hash（即文件 MD5），默认自动计算

extendname: 文件扩展名，默认为 mp3（自动去掉点号）

name: 云盘音乐显示名称，默认格式为 歌手名 - MD5.扩展名

author_name: 歌手名

hash_std: 曲库标准 hash，默认自动匹配

audio_id: 音频 id，默认为 0

album_audio_id: 专辑音频 id，默认为 0

auto_match: 是否自动匹配曲库，默认 1；传 0、false 或 no 可关闭

接口地址： /user/cloud/upload

调用例子： /user/cloud/upload

获取用户收藏的视频

说明：登录后调用此接口可以获取用户收藏的视频（需要登录）

可选参数

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /user/video/collect

调用例子： /user/video/collect

获取用户喜欢的视频

说明：登录后调用此接口可以获取用户喜欢的视频（需要登录）

可选参数

pagesize : 每页页数, 默认为 30

接口地址： /user/video/love

调用例子： /user/video/love

获取用户听歌历史排行

说明：登录后调用此接口，可以获取用户听歌历史排行

可选参数：

type：0 为获取最近一周前 120 首歌曲，1：获取全部累计前 120 首歌曲

接口地址： /user/listen

调用例子： /user/listen

获取用户最近听歌历史

说明：登录后调用此接口，可以近期的听歌历史记录(需要登陆)

可选参数：

bp: 可以更加上一次返回值传入

接口地址： /user/history

调用例子： /user/history

获取继续播放信息（对应手机版首页显示继续播放入口）

说明：登录后调用此接口，可以最后设备播放信息(需要登陆)

可选参数：

pagesize: 每页页数, 默认为 30

接口地址： /lastest/songs/listen

调用例子： /lastest/songs/listen

收藏歌单/新建歌单

说明 : 调用此接口, 可收藏歌单/新建歌单( 需要登录 ), 收藏成功后建议使用 /playlist/tracks/add 把原歌单下的歌曲添加到新的歌单

必选参数：

name: 歌单名称

list_create_userid: 歌单 list_create_userid

list_create_listid: 歌单 list_create_listid

可选参数

is_pri: 是否设为隐私，0：公开，1：隐私，仅支持创建歌单时传入

type: 1：为收藏歌单，0：创建歌单, 默认为 0

list_create_gid：歌单 list_create_gid

接口地址： /playlist/add

调用例子： /playlist/add?source=1&name=音乐一响%20纯爱登场.&list_create_userid=1782943844&list_create_listid=87

取消收藏歌单/删除歌单

说明 : 调用此接口 , 取消收藏歌单( 需要登录 )

必选参数：

listid: 用户歌单 listid

接口地址： /playlist/del

接口地址： /playlist/del?listid=xxx

对歌单添加歌曲

说明 : 调用此接口 , 可以添加歌曲到歌单 ( 需要登录 )

必选参数：

listid: 用户歌单 listid

data: 歌曲数据, 格式为 歌曲名称|歌曲 hash|专辑 id|(mixsongid/album_audio_id)，最少需要 歌曲名称以及歌曲 hash(若返回错误则需要全部参数)， 支持多个，每 个以逗号分隔

接口地址： /playlist/tracks/add

调用例子： /playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2 /playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2|67026620|477417208 /playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2,我们应该算爱过吧|5015FC3FAB5B0C245556A1CC3C4DE355

对歌单删除歌曲

说明 : 调用此接口 , 可以删除歌单某首歌曲 ( 需要登录 )

必选参数：

listid: 用户歌单 listid

fileids: 歌单中歌曲的 fileid，可多个,用逗号隔开

接口地址： /playlist/tracks/del

调用例子： /playlist/tracks/del?listid=1&fileids=xx /playlist/tracks/del?listid=1&fileids=xx,xx

新碟上架

说明: 调用此接口 , 可获取新碟上架列表, 如需要专辑详细信息需要调用album/detail, 如需要获取专辑音乐列表需调 用album/songs

可选参数：

type : 1：华语；2：欧美；3：日本；4：韩国；推荐为空，默认为空

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /top/album

调用例子： /top/album

专辑信息

说明: 调用此接口 ,传入专辑 id 可获取专辑相关信息

必选参数：

album_id: 专辑 id,可以传多个，以逗号分割

可选参数：

fields: 需要返回的信息，可以传多个，以逗号分割，支持的值有 trans_param special_tag authors album_name publish_date cover intro publish_company type album_id language_id is_publish heat grade quality exclusive grade_count author_name sizable_cover language category

接口地址： /album

调用例子： /album?album_id=xxx, /album?album_id=xxx,xxx, /album?album_id=xxx&fields=language,authors

专辑详情

说明: 调用此接口 ,传入专辑 id 可获取专辑详情

必选参数：

id: 专辑 id

接口地址： /album/detail

调用例子： /album/detail?id=10729818

专辑音乐列表

说明: 调用此接口 ,传入专辑 id 可获取专辑音乐列表

必选参数：

id: 专辑 id

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /album/songs

调用例子： /album/songs?id=10729818

获取音乐 URL

说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的 url, 未登录状态或者非会员可能会返回为空。

⚠️ 注意：因接口问题，目前获取 url 接口数据需要先调用 /register/dev 接口获取 dfid，否则会提示 本次请求需要验证

必选参数：

hash: 音乐 hash

可选参数：

album_id: 专辑 id

free_part: 是否返回试听部分（仅部分歌曲）

album_audio_id：专辑音频 id

quality：获取不同音质的 url

quality 支持的参数

piano：对应手机端魔法音乐 钢琴，仅部分音乐支持

acappella：对应手机端魔法音乐 人声 伴奏，仅部分音乐支持，该模式下返回的音频后缀为 mkv 格式，该文加存在 人声 和 伴奏 两个音轨

subwoofer：对应手机端魔法音乐 骨笛，仅部分音乐支持

ancient：对应手机端魔法音乐 尤克里里，仅部分音乐支持

surnay：对应手机端魔法音乐 唢呐，仅部分音乐支持

dj：对应手机端魔法音乐 DJ，仅部分音乐支持

128：返回 128 码率 mp3 格式

320：返回 320 码率 mp3 格式

flac：返回 flac 格式音频

high：返回无损格式音频

viper_atmos：蝰蛇全景声，仅部分音乐支持

viper_clear：蝰蛇超清音质

viper_tape：蝰蛇母带，仅部分音乐支持, 该音质需要转码，关于转码相关的技术还不会

super：返回 DSD 格式音频，支持的音频少的可伶

接口地址： /song/url

调用例子： /song/url?hash=xxx

获取音乐 URL（新版）

说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的 url, 未登录状态或者非会员可能会返回为空，该接口会一次性返回支持的音质的音频 url, 但该接口存 在音频加密（目前无法解码），请谨慎使用

⚠️ 注意：因接口问题，目前获取 url 接口数据需要先调用 /register/dev 接口获取 dfid，否则会提示 本次请求需要验证

必选参数：

hash: 音乐 hash

可选参数：

album_audio_id：专辑音频 id

free_part: 是否返回试听部分（仅部分歌曲）

album_audio_id：专辑音频 id

接口地址： /song/url/new

调用例子： /song/url/new?hash=xxx

获取歌曲高潮部分

说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的高潮时间

必选参数：

hash: 音乐 hash, 可以传多个，以逗号分割

接口地址： /song/climax

调用例子： /song/climax?hash=xxx

搜索

说明: 调用此接口 , 传入搜索关键词可以搜索该音乐 / mv / 歌单 / 歌词 / 专辑 / 歌手

必选参数：

keywords: 关键词

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

type: 搜索类型；默认为单曲，special：歌单，lyric：歌词，song：单曲，album：专辑，author：歌手，mv：mv

⚠️ 注意：因接口问题，获取搜索结果需要在 url 后添加cookie认证信息或者Set-cookie，否则会返回 error_code: 152

⚠️ 注意：建议请求在所有搜索接口时添加认证信息防止调用失败！

接口地址： /search

调用例子： /search?keywords=海阔天空（错误示例），/search?keywords=周杰伦&cookie=token=xxxx;userid=xxxx;dfid=xxxx（必须携带认证信息）

默认搜索关键词

说明 : 调用此接口 , 可获取默认搜索关键词

接口地址： /search/default

综合搜索

说明: 调用此接口, 传入搜索关键词可以获得综合搜索，搜索结果同时包含单曲 , 歌手 , 歌单等信息

必选参数：

keywords: 关键词

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /search/complex

调用例子： /search/complex?keywords=海阔天空

热搜列表

说明 : 调用此接口,可获取热门搜索列表

接口地址： /search/hot

调用例子： /search/hot

搜索建议

说明 : 调用此接口 , 传入搜索关键词可获得搜索建议 , 搜索结果同时包含单曲 , 歌手 , 歌单信息

可选参数：

albumTipCount : 专辑返回数量

correctTipCount : 目前未知，可能是歌单

mvTipCount : MV 返回数量

musicTipCount : 音乐返回数量

接口地址： /search/suggest

调用例子： /search/suggest?keywords=海阔天空

歌词搜索

说明: 调用此接口, 可以搜索歌词，该接口需配合 /lyric 使用。

必选参数：

keywords: 关键词，与 hash 二选一

hash: 歌曲 hash，与 keyword 二选一

可选参数：

album_audio_id: 专辑音乐 id,

duration：歌曲时间

man: 是否返回多个歌词，yes：返回多个， no：返回一个。 默认为no

接口地址： /search/lyric

调用例子： /search/lyric?keywords=xxx /search/lyric?keywords=xxx&hash=xxx

获取歌词

说明 : 调用此接口，可以获取歌词，调用该接口前则需要调用/search/lyric 获取完整参数

必选参数：

id: 歌词 id, 可以从 /search/lyric 接口中获取

accesskey: 歌词 accesskey, 可以从 /search/lyric 接口中获取

可选参数：

fmt: 歌词类型，lrc 为普通歌词，krc 为逐字歌词

decode: 是否解码，传入该参数这返回解码后的歌词

接口地址： /lyric

调用例子： /lyric?id=xxx&accesskey=xxx /lyric?id=xxx&accesskey=xxx&fmt=lrc /lyric?id=xxx&accesskey=xxx&decode=true

歌单分类

说明 : 调用此接口,可获取歌单分类,包含 category 信息

接口地址： /playlist/tags

调用例子： /playlist/tags

歌单

说明 : 调用此接口 , 可获取歌单

必选参数：

category_id: tag，0：推荐，11292：HI-RES，其他可以从 /playlist/tags 接口中获取（接口下的 tag_id 为 category_id的值）

可选参数：

withsong: 是否返回歌曲列表（不全），0：不返回，1：返回

withtag: 是否返回歌单分类，0：不返回，1：返回

接口地址： /top/playlist

调用例子： /top/playlist?category_id=0

主题歌单

说明 : 调用此接口 , 可获取主题歌单, 通过 /theme/playlist/track 可以获取主题个单下的歌曲

接口地址： /theme/playlist

调用例子： /theme/playlist

音效歌单

说明 : 调用此接口 , 可获取音效歌单

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /playlist/effect

调用例子： /playlist/effect

获取歌单详情

说明: 调用此接口 , 可获取歌单详细信息

必选参数：

ids: 歌单中的 global_collection_id，可以传多个，用逗号分隔

接口地址： /playlist/detail

调用例子： /playlist/detail?ids=collection_3_1863870844_4_0 /playlist/detail?ids=collection_3_1863870844_4_0,collection_3_2093906551_8_0

获取歌单所有歌曲

说明 : 调用此接口，传入对应的歌单 global_collection_id，即可获得对应的所有歌曲

必选参数：

id: 歌单中的 global_collection_id

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /playlist/track/all

调用例子： /playlist/track/all?id=collection_3_1863870844_4_0

获取歌单所有歌曲(新版)

说明 : 调用此接口，传入对应的歌单 listid，即可获得对应的所有歌曲, 目前该接口仅支持 用户所创建及收藏的歌单

必选参数：

lisdid: 歌单中的 listid

可选参数：

page : 页数

pagesize : 每页页数, 默认为 30

接口地址： /playlist/track/all/new

调用例子： /playlist/track/all/new?listid=xxx

相似歌单

说明 : 调用此接口，根据歌单 id 获取相似歌单

必选参数：

ids：歌单 global_collection_id，支持多个，每个以逗号分隔

接口地址： /playlist/similar

调用例子： /playlist/similar?ids=collection_1_1341266283_964007_0 /playlist/similar?ids=collection_1_1341266283_964007_0,collection_3_1041185112_11_0

获取主题歌单所有歌曲

必选参数：

theme_id: 主题歌单 id

接口地址： /theme/playlist/track

调用例子： /theme/playlist/track?theme_id=18

获取主题音乐

说明 : 调用此接口，可以获取主题音乐，调用 /theme/music/detail 可以获取主题音乐详情

接口地址： /theme/music

调用例子： /theme/music

获取主题音乐详情

说明 : 调用此接口，传入对应的主题 id 可以获取主题音乐详情.

必选参数：

id: 主题音乐 id

接口地址： /theme/music/detail

调用例子： /theme/music/detail?id=1002

歌曲推荐

说明 : 调用此接口，可以获取歌曲推荐.

必选参数：

card_id: 1：对应安卓 精选好歌随心听 || 私人专属好歌，2：对应安卓 经典怀旧金曲，3：对应安卓 热门好歌精选，4：对应安卓 小众宝藏佳作，5：未知，6：对应 vip 专属推荐

接口地址： /top/card

调用例子： /top/card?card_id=1

歌曲推荐（概念版）

说明 : 调用此接口，可以获取歌曲推荐

必选参数：

card_id: 3006: VIP 专属推荐，3001: 私人专属好歌，3004: 小众宝藏佳作，3014: 喜欢这首歌的 TA 也喜欢，3101: 概念 er 新推，3005: 潮流尝鲜

可选参数

pagesize: 每页页数, 默认为 30

接口地址： /top/card

调用例子： /top/card/youth?card_id=3006

获取歌手和专辑图片

说明 : 调用此接口，可以获取歌手和专辑图片.

必选参数：

hash: 歌曲 hash, 可以传多个，每个以逗号分开

可选参数：

album_id: 专辑 id, 可以传多个，每个以逗号分开

album_audio_id: 专辑音乐 id, 可以传多个，每个以逗号分开

count: 最多返回多少张图片，默认为 5

接口地址： /images

调用例子： /images?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE /image?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368&album_id=,75013431

获取歌手图片

说明 : 调用此接口，可以获取歌手图片.

必选参数：

hash: 歌曲 hash, 可以传多个，每个以逗号分开

可选参数：

audio_id: 音乐 id, 可以传多个，每个以逗号分开

album_audio_id: 专辑音乐 id, 可以传多个，每个以逗号分开

filename: 音乐文件名称, 可以传多个，每个以逗号分开

count: 最多返回多少张图片，默认为 5

接口地址： /images/audio

调用例子： /images/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE /image/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368

获取音乐相关信息

说明：调用此接口，可以获取音乐相关信息

必选参数：

hash: 歌曲 hash, 可以传多个，每个以逗号分开

接口地址： /audio

调用例子： /audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE /audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368

获取更多音乐版本

说明：调用此接口，可以获取更多版本音乐

必选参数：

album_audio_id：音乐的 mixsongid/album_audio_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

show_type：是否返回分类

sort：排序，支持 all，hot，new

type: 分类

show_detail：是否返回详情，否则只返回总数，0：只返回总数，不传或者其他都返回详情

接口地址： /audio/related

调用例子： /audio/related?album_audio_id=573120919 /audio/related?album_audio_id=573120919&show_detail=0

获取音乐伴奏信息

说明：调用此接口，可以获取最佳伴奏信息

必选参数：

hash：音乐 hash

fileName: 音乐 fileName

mixid: 音乐的 mixsongid/album_audio_id

接口地址： /audio/accompany/matching

调用例子： /audio/accompany/matching?fileName=希林娜依高 - Shine Brighter (愈加璀璨)&mixId=637735200&hash=6D431B0507587447B3D7345434DC5825

获取音乐 K 歌数量

说明：调用此接口，可以获取音乐 K 歌数量，参数信息均来自获取音乐伴奏信息

必选参数：

songId：音乐 songid, 该字段需要请求 获取音乐伴奏信息 获取

singerName：歌手名称，多个以 、 隔开，也可以到 获取音乐伴奏信息 中获取

songHash：音乐 hash, 该字段需要请求 获取音乐伴奏信息 获取

接口地址： /audio/ktv/total

调用例子： /audio/ktv/total?songId=43522508&singerName=希林娜依高&songHash=99AE5A7B04FF76550E380C3757D3E273

获取音乐详情

说明：调用此接口，可以获取音乐详情

必选参数：

hash: 歌曲 hash, 可以传多个，每个以逗号分开

接口地址： /privilege/lite

调用例子： /privilege/lite?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE /privilege/lite?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368

获取音乐专辑/歌手信息

说明：调用此接口，可以获取音乐专辑/歌手信息

必选参数：

album_audio_id: 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开

可选参数

fields: 可以传 album_info authors.base base audio_info, authors.ip, extra, tags, tagmap 每个 field 以逗号分开

接口地址： /krm/audio

调用例子： /krm/audio?album_audio_id=32155307 /krm/audio?album_audio_id=32155307&fields=album_info,base,authors.base

私人 FM(对应手机和 pc 端的猜你喜欢)

说明 : 私人 FM

可选参数：

hash: 音乐 hash, 建议

songid: 音乐 songid, 建议

playtime: 已播放时间, 建议

mode: 获取模式，默认为 normal, normal：发现，small： 小众，peak：30s

action: 默认为 play, garbage: 为不喜欢

song_pool_id： 手机版的 AI，0：Alpha 根据口味推荐相似歌曲, 1：Beta 根据风格推荐相似歌曲, 2：Gamma

is_overplay: 是否已播放完成

remain_songcnt: 剩余未播放歌曲数, 默认为 0，大于 4 不返回推荐歌曲，建议

接口地址： /personal/fm

调用例子： /personal/fm

banner

说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据

接口地址： /pc/diantai

调用例子： /pc/diantai

乐库 banner

说明 : 调用此接口 , 可获取 乐库 banner( 轮播图 ) 数据

接口地址： /yueku/banner

调用例子： /yueku/banner

乐库电台

说明 : 调用此接口 , 可获取乐库电台数据

接口地址： /yueku/fm

调用例子： /yueku/fm

乐库

说明 : 调用此接口 , 可获取手机端乐库数据

接口地址： /yueku

调用例子： /yueku

电台

说明 : 调用此接口 , 可获取所有电台数据

接口地址： /fm/class

调用例子： /fm/class

电台 - 推荐

说明 : 调用此接口 , 可获取推荐电台

接口地址： /fm/recommend

调用例子： /fm/recommend

电台 - 图片

说明 : 调用此接口 , 可获取对应电台的图片

必选参数：

fmid: fmid，可以传多个，以逗号分割

接口地址： /fm/image

调用例子： /fm/image?fmid=693 /fm/image?fmid=693,37

电台 - 音乐列表

说明 : 调用此接口 , 可获取对应电台的音乐列表

必选参数：

fmid: fmid，可以传多个，以逗号分割

可选参数：

fmtype: fmtype, 可以传多个，以逗号分割

fmoffset: 歌曲偏移，可以传多个，以逗号分割

fmsize: 歌曲列表大小，可以传多个，以逗号分割

接口地址： /fm/songs

调用例子： /fm/image?fmid=693 /fm/image?fmid=693,37&fmtype=2,2&fmoffset=,5&fmsize5,3

编辑精选

说明 : 调用此接口 , 可获取编辑精选数据

接口地址： /top/ip

调用例子： /top/ip

编辑精选数据

说明 : 调用此接口 , 可获取编辑对应数据

必选参数：

id: ip id

可选参数：

type: 数据类型，audios: 音乐, albums: 专辑, videos: 视频, author_list: 歌手

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /ip

调用例子： /ip?id=87473 ip?id=87473&type=author_list

编辑精选歌单

说明：调用此接口，可获取编辑精选歌单数据

必选参数：

id: ip id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /ip/playlist

调用例子： /ip/playlist?id=87473

编辑精选专区

说明：调用此接口，可获取编辑精选专区相关内容，若数据中没有 ip_id，可使用/ip/zone/home来获取数据

接口地址： /ip/zone

调用例子： /ip/zone

编辑精选专区详情

说明：调用此接口，可获取编辑精选专区详情，若/ip/zone 数据中没有 ip_id，可使用该接口获取数据

必选参数：

id: ip id

接口地址： /ip/zone/home

调用例子： /ip/zone/home?id=329

领取 VIP（需要登陆，该接口为测试接口,仅限概念版使用，该接口目前不可使用）

说明 : 调用此接口 , 每天可领取 1 天 VIP 时长，需要领取 8 次，每次增加 3 小时，该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁调用)

接口地址： /youth/vip

调用例子： /youth/vip

领取一天 VIP（需要登陆，该接口为测试接口,仅限概念版使用）

说明 : 调用此接口 , 领取概念版 VIP，传入日期可领取改日期一天 VIP，该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁调用)

注意 ⚠️：建议不要领太多天

必选参数：

receive_day: 领取 VIP 日期，格式为：2026-01-30

接口地址： /youth/day/vip

调用例子： /youth/day/vip

升级概念版 VIP（需要登录，需要先领取一天 VIP，该接口为测试接口,仅限概念版使用）

说明 : 调用此接口 , 可以升级成畅听 VIP，该接口需要先领取一天 VIP（/youth/day/vip），该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁 调用)

接口地址： /youth/day/vip/upgrade

调用例子： /youth/day/vip/upgrade

获取当月已领取 VIP 天数（需要登陆，该接口为测试接口,仅限概念版使用）

说明 : 调用此接口 ,获取当月已领取 VIP 天数

接口地址： /youth/month/vip/record

调用例子： /youth/month/vip/record

获取已领取 VIP 状态（需要登陆，该接口为测试接口,仅限概念版使用）

说明 : 调用此接口 ,获取已领取 VIP 状态

接口地址： /youth/union/vip

调用例子： /youth/union/vip

获取歌手列表

说明 : 调用此接口，可以获取歌手列表.

可选参数：

sextypes：性别类型，0：全部，1：男，2：女，3：组合

type：类型，0：全部，1：华语，2：欧美，3：日韩，4：其他，5：日本，6：韩国

musician：音乐人，3：为音乐人,0：默认

hotsize：返回热门数量，默认 30

接口地址： /artist/lists

调用例子： /artist/lists

获取歌手详情

说明 : 调用此接口 , 传入歌手 id, 可获得歌手信息

必选参数：

id： 歌手 id

接口地址： /artist/detail

调用例子： /artist/detail?id=6539

获取歌手专辑

说明 : 调用此接口 , 传入歌手 id, 可获得歌手专辑

必选参数：

id： 歌手 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

sort: 排序，hot : 热门, new: 最新

接口地址： /artist/albums

调用例子： /artist/albums?id=6539

获取歌手单曲

说明 : 调用此接口 , 传入歌手 id, 可获得歌手歌曲

必选参数：

id： 歌手 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

sort: 排序，hot : 热门, new: 最新

接口地址： /artist/audios

调用例子： /artist/audios?id=6539

获取歌手 MV

说明 : 调用此接口 , 传入歌手 id, 可获得歌手 MV

必选参数：

id： 歌手 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

tag: official: 官方版本，live：现场版本，fan：饭制版本，artist: 歌手发布, all: 获取全部，默认为获取全部

接口地址： /artist/videos

调用例子： /artist/videos?id=6539

关注歌手

说明：调用此接口, 传入歌手 id, 可以关注该歌手（需要登录）

必选参数：

id: 歌手 id

接口地址： /artist/follow

调用例子： /artist/follow?id=6539

取消关注歌手

说明：调用此接口, 传入歌手 id, 可以取消关注该歌手（需要登录）

必选参数：

id: 歌手 id

接口地址： /artist/unfollow

调用例子： /artist/unfollow?id=6539

获取关注歌手新歌

说明：调用此接口, 可以获取用户已关注的歌手新歌（需要登录）

可选参数：

last_album_id: 最后专辑 id

pagesize: 每页页数, 默认为 30,

opt_sort: 排序，1：时间，2：亲密度，默认为 1(时间)

接口地址： /artist/follow/newsongs

调用例子： /artist/follow/newsongs

获取视频 url

说明 : 传入的视频的 hash, 可以获取对应的视频的 url

必选参数：

hash: 视频 hash

接口地址： /video/url

调用例子： /video/url?hash=3B5EE16299F703AEB0E5C28CB152EDF0

获取歌曲 MV

说明 : 传入 album_audio_id/MixSongID 获取歌曲 相对应的 mv

必选参数：

album_audio_id: 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开,

可选参数：

fields: 支持多个，每个以逗号分隔，支持的值有：mkv,tags,h264,h265,authors

接口地址： /kmr/audio/mv

调用例子： /kmr/audio/mv?album_audio_id=32155307 /kmr/audio/mv?album_audio_id=32155307&fields=mkv,tags

获取视频相关信息

说明 : 传入的视频的 hash, 可以获取对应的视频的相关信息

必选参数：

hash: 视频 hash，可以传多个，以逗号隔开

接口地址： /video/privilege

调用例子： /video/privilege?hash=3B5EE16299F703AEB0E5C28CB152EDF0

获取视频详情

说明：调用此接口，可以获取视频详情，可以获取更高清的视频 hash

必选参数：

id: 视频 id/video id

接口地址： /video/detail

调用例子： /video/detail?id=11517822

新歌速递

说明：调用此接口，可以获取新歌速递

接口地址： /top/song

调用例子： /top/song

场景音乐列表

说明：调用此接口，可以场景音乐列表

接口地址： /scene/lists

调用例子： /scene/lists

场景音乐详情

说明：调用此接口，可以场景音乐详情

必选参数：

id: 场景音乐 scene_id

接口地址： /scene/module

调用例子： /scene/module?id=9

获取场景音乐讨论区

说明：调用此接口，可以获取场景音乐讨论区

必选参数

id: 场景音乐 scene_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

sort: 排序，rec: 推荐，hot: 热门，new: 最新, 默认为推荐

接口地址： /scene/list/v2

调用例子： /scene/list/?id=9

获取场景音乐模块 Tag

说明：调用此接口，可以获取场景模块 Tag

必选参数

id: 场景音乐 scene_id

module_id: 场景音乐 module_id

可选参数：

接口地址： /scene/module/info

调用例子： /scene/module/info?id=9&module_id=83

获取场景音乐歌单列表

说明：调用此接口，可以获取场景音乐歌单列表

必选参数

tag_id: 场景音乐 tag_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /scene/collection/list

调用例子： /scene/collection/list?tag_id=42391

获取场景音乐视频列表

说明：调用此接口，可以获取场景音乐视频列表

必选参数

tag_id: 场景音乐视频 tag_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /scene/video/list

调用例子： /scene/video/list?tag_id=42399

获取场景音乐音乐列表

说明：调用此接口，可以获取场景音乐音乐列表

必选参数

id: 场景音乐 scene_id

module_id: 场景音乐 module_id

tag: 场景音乐 tag_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /scene/audio/list

调用例子： /scene/audio/list?id=9&module_id=173&tag=42391

每日推荐

说明：调用此接口，可以获取每日推荐列表

可选参数：

platform：设备类型，默认为 ios,支持 android 和 ios

接口地址： /everyday/recommend

调用例子： /everyday/recommend

历史推荐

说明：调用此接口，可以获取历史推荐

可选参数：

mode：当 mode 为 list 时，则返回历史推荐列表，当 mode 为 song 时则返回当前歌曲列表，支持参数为：list 和 song,

history_name: 当 mode 为 song 该参数为必选参数。

date: 当 mode 为 song 该参数为必选参数。

platform：设备类型，默认为 ios,支持 android 和 ios

接口地址： /everyday/history

调用例子： /everyday/history /everyday/history?mode=song&history_name=RT_336d5ebc5436534e61d16e63ddfca327_20240106&date=20240106

风格推荐

说明：调用此接口，可以获取风格推荐

可选参数：

platform：设备类型，默认为 ios,支持 android 和 ios

tagids：支持多个，每个以逗号分隔，该接口下可获取 tag 信息

接口地址： /everyday/style/recommend

调用例子： /everyday/style/recommend /everyday/style/recommend?tagids=S14,S15,S16

排行列表

说明：调用此接口，可以获取排行榜列表

可选参数：

withsong：是否返回歌曲（部分）

接口地址： /rank/list

调用例子： /rank/list

排行榜推荐列表

说明：调用此接口，可以获取排行榜推荐列表

接口地址： /rank/top

调用例子： /rank/top

排行榜往期列表

说明：调用此接口，可以获取排行榜往期列表

必选参数：

rankid：排行榜 id

可选参数：

rank_cid：排行榜 cid

接口地址： /rank/vol

调用例子： /rank/vol?rankid=8888

排行榜信息

说明：调用此接口，可以获取排行榜信息

必选参数：

rankid：排行榜 id

可选参数：

rank_cid：排行榜 cid

album_img：是否返回专辑图片，1：返回，0：不返回，默认返回

zone：排行榜 zone

接口地址： /rank/info

调用例子： /rank/info?rankid=8888

排行榜歌曲列表

说明：调用此接口，可以获排行榜歌曲列表

必选参数：

rankid：排行榜 id

可选参数：

rank_cid：若需要返回往期歌曲列表，则该参数为必填，否则默认返回最新一期，/rank/vol 返回值中，volid 则为该参数

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /rank/audio

调用例子： /rank/audio?rankid=8888 /rank/audio?rankid=8888&rank_cid=76442

歌曲收藏数

说明 : 调用此接口 , 传入音乐 mixsongids 参数 , 可获得该音乐的收藏数( 不需要登录 )

必选参数：

mixsongids：音乐 mixsongid，多个以逗号分隔

接口地址： /favorite/count

调用例子： /favorite/count?mixsongids=368015985,368015986 /favorite/count?mixsongids=368015985

歌曲评论数

说明 : 调用此接口 , 传入音乐 hash/special_id 参数 , 可获得该音乐的评论数( 不需要登录 )

必选参数：

hash：音乐 hash

special_id：为 评论下的 special_child_id 字段

接口地址： /comment/count

调用例子： /comment/count?hash=98eb07ad8eaf74bf56dece55518ad63e /comment/count?special_id=20505418

歌曲评论

说明 : 调用此接口 , 传入音乐 mixsongid 参数 , 可获得该音乐的所有评论 ( 不需要登录 )

必选参数：

mixsongid：音乐 mixsongid

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

show_classify： 是否返回分类列表，0 为不返回，1 为返回

show_hotword_list：是否返回热词，0 为不返回，1 为返回

接口地址： /comment/music

调用例子： /comment/music?mixsongid=302362878

歌曲评论-根据分类返回

说明 : 调用此接口 , 传入音乐 mixsongid 和 type_id 参数 , 可获得该音乐的分类评论 ( 不需要登录 )

必选参数：

mixsongid：音乐 mixsongid

type_id：分类 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

sort：排序，1 为正序，2 为倒序

接口地址： /comment/music/classify

调用例子： /comment/music/classify?mixsongid=302362878&type_id=12

歌曲评论-根据热词返回

说明 : 调用此接口 , 传入音乐 mixsongid 和 hot_word 参数 , 可获得该音乐的热词评论 ( 不需要登录 )

必选参数：

mixsongid：音乐 mixsongid

hot_word：热词

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /comment/music/hotword

调用例子： /comment/music/hotword?mixsongid=302362878&hot_word=生活

楼层评论

说明 : 调用此接口 , 传入资源 special_id 和资源类型 tid 和资源 mixsongid 参数, 可获得该资源的歌曲楼层评论

必选参数：

special_id：为 评论下的 special_child_id 字段

mixsongid：为 歌曲的 mixsongid

tid：评论 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

接口地址： /comment/floor

调用例子： /comment/floor?special_id=100285259&mixsongid=302362878&tid=678433417

歌单评论

说明 : 调用此接口 , 传入歌单 id 参数 , 可获得该歌单的所有评论 ( 不需要登录 )

必选参数：

id：歌单 global_collection_id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

show_classify： 是否返回分类列表，0 为不返回，1 为返回

show_hotword_list：是否返回热词，0 为不返回，1 为返回

接口地址： /comment/playlist

调用例子： /comment/playlist?id=collection_3_1373407643_366_0

专辑评论

说明 : 调用此接口 , 传入 专辑 id 参数 , 可获得该专辑的所有评论 ( 不需要登录 )

id：专辑 id

可选参数：

page： 页码

pagesize: 每页页数, 默认为 30

show_classify： 是否返回分类列表，0 为不返回，1 为返回

show_hotword_list：是否返回热词，0 为不返回，1 为返回

接口地址： /comment/album

调用例子： /comment/album?id=collection_3_1373407643_366_0

提交听歌历史

说明：提交听歌历史后，支持在其他设备上查看听歌历史

必选参数：

mxid： 专辑音乐 id (album_audio_id/MixSongID 均可以)

可选参数：

ot：当前时间戳, 秒级，不要传入毫秒级，否者会返回错误，或者从 获取服务器时间 中获取

pc: 当前播放次数，更新播放次数，当服务器的值大于传入值时，将维持服务最大值，否则更新

接口地址： /playhistory/upload

调用例子： /playhistory/upload?mxid=32155307

获取服务器时间

说明：获取服务器时间，返回服务器时间戳

接口地址： /server/now

调用例子： /server/now

刷刷

说明：获取刷刷视频

接口地址： /brush

调用例子： /brush

AI 推荐

说明：传入 album_audio_id/MixSongID 获取 AI 推荐歌曲

必选参数：

album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开,

接口地址： /ai/recommend

调用例子： /ai/recommend?album_audio_id=274565080 /ai/recommend?album_audio_id=274565080,68435124

曲谱 - 获取歌曲曲谱

说明 : 调用此接口，传入歌曲 album_audio_id/MixSongID 可获得该歌曲的曲谱，注意：需要自己解析，别问我，我也看不懂

必选参数：

album_audio_id：音乐的 mixsongid/album_audio_id

可选参数：

instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱

level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）

接口地址： /sheet/song

调用例子： /sheet/song?album_audio_id=68435136

曲谱 - 曲谱详情

说明 : 调用此接口，传入曲谱 opern_id 可获得该曲谱详情，注意：需要自己解析，别问我，我也看不懂

必选参数：

opern_id：曲谱 id,

接口地址： /sheet/detail

调用例子： /sheet/detail?id=68435136_1_0

曲谱 - 曲谱排行榜

说明 : 调用此接口，可以获取推荐排行榜

可选参数：

instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱

level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /sheet/rank

调用例子： /sheet/rank

曲谱 - 曲谱广场

说明 : 调用此接口，可以获取推荐曲谱

可选参数：

instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱

level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）

page：页数

pagesize : 每页页数, 默认为 30

tagid: 标签, 通过 /sheet/tags 获取

接口地址： /sheet/explore

调用例子： /sheet/explore

曲谱 - 曲谱标签

说明 : 调用此接口，可以获取曲谱标签

接口地址： /sheet/tags

调用例子： /sheet/tags

频道 - 获取用户所有频道

说明：登录后调用此接口，可以获取用户所有订阅的频道

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /youth/channel/all

调用例子： /youth/channel/all

频道 - 详情

说明：调用此接口，传入 global_collection_id / channel_id 可以获取频道详情

必选参数：

global_collection_id：频道 id (global_collection_id / channel_id 均可以), 可以传多个，每个以逗号分开,

接口地址： /youth/channel/detail

调用例子： /youth/channel/detail?global_collection_id=11576464149

频道 - 频道安利

说明：调用此接口，传入 global_collection_id / channel_id 可以获取频道安利

必选参数：

global_collection_id：频道 id (global_collection_id / channel_id 均可以)

接口地址： /youth/channel/amway

调用例子： /youth/channel/amway?global_collection_id=11576464149

频道 - 相似频道

说明：调用此接口，传入 global_collection_id / channel_id 可以获取相似频道

必选参数：

channel_id：频道 id (global_collection_id / channel_id 均可以)

接口地址： /youth/channel/similar

调用例子： /youth/channel/similar?channel_id=11576464149

频道 - 订阅

说明：登录后调用此接口， 传入 global_collection_id / channel_id 可订阅频道

必选参数：

global_collection_id：频道 id (global_collection_id / channel_id 均可以)

可选参数：

t：1 为订阅，0 为取消订阅，不传默认为订阅

接口地址： /youth/channel/sub

调用例子： /youth/channel/sub?global_collection_id=11576464149 /youth/channel/sub?global_collection_id=11576464149&t=0

频道 - 音乐故事

说明：调用此接口，传入 global_collection_id / channel_id 可以获取音乐故事

必选参数：

global_collection_id：频道 id (global_collection_id / channel_id 均可以)

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /youth/channel/song

调用例子： /youth/channel/song?global_collection_id=11576464149

频道 - 音乐故事详情

说明：调用此接口，传入 global_collection_id / channel_id 和 fileid 可以获取音乐故事详情

必选参数：

global_collection_id：频道 id (global_collection_id / channel_id 均可以)

fileid: 音乐故事 fileid

接口地址： /youth/channel/song/detail

调用例子： /youth/channel/song/detail?global_collection_id=11576464149&fileid=1720958083456581

动态 - 最常访问

说明：登录后调用此接口，可以获取经常访问的频道和用户

接口地址： /youth/dynamic/recent

调用例子： /youth/dynamic/recent

获取用户公开的音乐

说明：调用此接口，可以获取用户公开的音乐

必选参数：

userid：用户 id

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /youth/user/song

调用例子： /youth/user/song?userid=1354894105

听书 - 每日推荐

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /longaudio/daily/recommend

调用例子： /longaudio/daily/recommend

听书 - 排行榜推荐

接口地址： /longaudio/rank/recommend

调用例子： /longaudio/rank/recommend

听书 - VIP 推荐

接口地址： /longaudio/vip/recommend

调用例子： /longaudio/vip/recommend

听书 - 每周推荐

接口地址： /longaudio/week/recommend

调用例子： /longaudio/week/recommend

听书 - 专辑详情

必选参数：

album_id: 专辑 id 可以传多个，每个以逗号分开,

接口地址： /longaudio/album/detail

调用例子： /longaudio/album/detail?album_id=56655759

听书 - 专辑音乐列表

必选参数：

album_id: 专辑 id 可以传多个

接口地址： /longaudio/album/audios

调用例子： /longaudio/album/audios?album_id=56655759

歌曲详情 - 歌曲成绩单

说明：调用此接口，可以获取歌曲详情里面的歌曲成绩单信息

必选参数：

album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以),

接口地址： /song/ranking

调用例子： /song/ranking?album_audio_id=32155307

歌曲详情 - 歌曲成绩单详情

说明：登陆后调用此接口，可以获取更详细的歌曲成绩单信息

必选参数：

album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以),

可选参数：

page：页数

pagesize : 每页页数, 默认为 30

接口地址： /song/ranking/filter

调用例子： /song/ranking/filter?album_audio_id=32155307

验证码 - 获取验证码格式

说明：碰到错误码 20028 时，可调用该接口获取验证码的格式。

必选参数：

eventid：当请求出现错误码为 20028 时，一般会返回

接口地址： /get/verify/info

调用例子： /get/verify/info?eventid=gz_tx_event_xxx

验证码 - 验证验证码格式

说明：通过验证码后通过该请求验证。（目前仅实现了腾讯验证码，其他的没碰到）

必选参数：

eventid：当请求出现错误码为 20028 时，一般会返回

v_type：/get/verify/info 下获取

verifycode：通过滑块验证码等获取

sid：通过 wasm 获取，具体可查看 public\login_captcha.html

edt：同上

接口地址： /verify/user/info

调用例子： /verify/user/info?eventid=gz_tx_event_xxx&v_type=xx&verifycode=xxx&sid=xxx&edt=xxx

听歌识曲

说明：调用此接口，传入 PCM 音频数据（application/octet-stream），可识别歌曲信息。该接口必须使用 POST 请求

必选参数：

data：PCM 音频二进制数据（16bit 采样，通过 POST body 以 application/octet-stream 格式传入）

接口地址： /audio/match

调用例子： 使用 POST 请求，Content-Type: application/octet-stream，body 为 PCM 二进制数据

// 前端示例
const res = await fetch('/audio/match', {
  method: 'POST',
  headers: { 'Content-Type': 'application/octet-stream' },
  body: pcmArrayBuffer,
});

获取已购单曲

说明：登录后调用此接口，可以获取用户已购买的单曲列表，返回歌曲详情及音频信息（需要登录）

可选参数：

page：页数

pagesize：每页页数，默认为 50

接口地址： /user/purchased/songs

调用例子： /user/purchased/songs

获取已购专辑

说明：登录后调用此接口，可以获取用户已购买的专辑列表（需要登录）

可选参数：

page：页数

pagesize：每页页数，默认为 15

接口地址： /user/purchased/albums

调用例子： /user/purchased/albums

License

The MIT License (MIT)