# 音乐聚合

**请求方式:** GET|POST

**接口地址:** https://api.hk0.cc/api/music

**接口描述:** 多平台音乐聚合接口:搜索、歌曲详情、播放直链、歌词,支持 QQ音乐、网易云音乐、酷我音乐、酷狗音乐、咪咕音乐、汽水音乐

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| type | string | 1 | 可选 | — | — | 操作类型:search 搜索 / song 详情 / url 直链 / lyric 歌词 / card 卡片JSON / platforms 平台列表 / resolve 识别分享链接 |
| platform | string | 2 | 可选 | — | — | 平台:qq / netease / kuwo / kugou / migu / qishui / all,默认 all |
| keyword | string | 3 | 可选 | — | — | 搜索关键词,也支持 q / w / msg / name |
| id | string | 4 | 可选 | — | — | 歌曲ID,也支持 mid / hash / musicId / contentId / track_id |
| share | string | 5 | 可选 | — | — | 歌曲分享链接,可自动识别平台并提取ID,也支持 link / song |
| quality | string | 6 | 可选 | — | — | 音质:standard / exhigh / lossless / hires,默认 standard |
| page | int | 7 | 可选 | — | — | 页码,默认 1 |
| limit | int | 8 | 可选 | — | — | 每页数量,默认 10,最大 30 |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "platform": "qq",
    "keyword": "晴天",
    "page": 1,
    "limit": 2,
    "total": 2,
    "list": [
      {
        "platform": "qq",
        "id": "0039MnYb0qxYhV",
        "name": "晴天",
        "artist": "周杰伦",
        "album": "叶惠美",
        "duration": 269,
        "cover": "https://y.gtimg.cn/music/photo_new/T002R500x500M000000MkMni19ClKG.jpg",
        "webUrl": "https://y.qq.com/n/ryqq/songDetail/0039MnYb0qxYhV"
      }
    ]
  },
  "version": "1.0.1"
}
```