酷我音乐API接口文档
缓存说明
为提升性能，接口设置了缓存机制。如需实时数据，请在请求参数中添加时间戳：
timestamp=${Date.now()}
示例：/first-geturl?keyword=海阔天空&quality=lossless×tamp=1698234567890
1. 模糊查找
通过关键词搜索歌曲，并返回第一个匹配结果的URL。
GET /first-geturl?keyword=关键词&quality=音质
请求参数
| 参数名 | 必选 | 说明 |
|---|---|---|
| keyword | 是 | 搜索关键词，例如：歌曲名 歌手名 |
| quality | 是 | 音质选择，可选值：lossless等 |
| timestamp | 否 | 时间戳，用于跳过缓存获取实时数据 |
示例
/first-geturl?keyword=最伟大的作品 周杰伦&quality=lossless
2. 精确查找
通过精确的歌曲信息搜索，支持结果验证。
GET /precise-get?songname=歌名&artist=歌手&duration=时长&quality=音质&withurl=true
请求参数
| 参数名 | 必选 | 说明 |
|---|---|---|
| songname | 是 | 歌曲名称 |
| artist | 是 | 歌手名称，多个歌手用&分隔 |
| duration | 否 | 歌曲时长（秒），可选 |
| withurl | 是 | 是否返回URL，填true |
| quality | 是 | 音质选择 |
示例
/precise-get?songname=最伟大的作品&artist=周杰伦&duration=244&quality=lossless&withurl=true
3. ID获取
通过歌曲ID直接获取播放URL。
GET /url?id=歌曲ID&quality=音质
请求参数
| 参数名 | 必选 | 说明 |
|---|---|---|
| id | 是 | 歌曲ID |
| quality | 是 | 音质选择 |
示例
/url?id=226543302&quality=lossless