# 咪咕音乐

**请求方式:** GET

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

**接口描述:** 咪咕音乐搜索与解析: 支持关键词搜索、按 contentId 取详情与播放直链、解析咪咕分享链接、获取 LRC 歌词; keyword+n 可直接出单曲(本地咪咕源, 失败回退 xcvts 上游). 直链支持 无损(SQ)/320k(HQ)/128k(PQ) 三档音质, 会员曲目返回元数据并标记 playable=false 与版权提示.

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| type | string | query | 可选 | — | — | 操作类型: search 搜索 / song 歌曲详情 / url 仅返回直链 / lyric 仅返回歌词; 不传按参数自动判断(contentId 优先于 keyword) |
| keyword | string | query | 可选 | — | — | 搜索关键词, 如 周杰伦、卡农; type=search 时必填。也接受 msg/name/q/w/s/text |
| contentId | string | query | 可选 | — | — | 咪咕内容ID, 搜索结果的 id 字段即为 contentId。也接受 content_id/cid/id/mid |
| url | string | query | 可选 | — | — | 咪咕歌曲分享链接, 自动提取其中的 contentId |
| page | int | query | 可选 | — | — | 页码, 默认 1 |
| limit | int | query | 可选 | — | — | 每页数量, 默认 10, 最大 30。也接受 pageSize/count |
| br | string | query | 可选 | — | — | 音质: 1/SQ 无损, 2/HQ 320k, 3/PQ 128k; 默认 3。也接受 quality/toneFlag |
| lyric | int | query | 可选 | — | — | 传 0 不返回歌词 (默认 1 返回) |
| fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |
| n | int | query | 可选 | — | — | 选曲序号: 配合 keyword 使用, 传 n=1 直接返回第 1 首的完整信息(含直链与歌词)。也接受 index/num |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "platform": "migu",
    "id": "600929000007387732",
    "contentId": "600929000007387732",
    "copyrightId": "69096300605",
    "name": "卡农(钢琴小提琴版)",
    "artist": "dylanf",
    "album": "卡农(经典钢琴版)",
    "duration": 320,
    "cover": "https://d.musicapp.migu.cn/data/oss/resource/00/5l/ff/211df3c67dca40e78086d509781bb842.webp",
    "pay": false,
    "playable": true,
    "quality": "standard",
    "bit_rate": 128,
    "ext": "mp3",
    "url": "https://freetyst.nf.migu.cn/public/product9th/...",
    "web_url": "https://music.migu.cn/v3/music/song/600929000007387732",
    "source": "local",
    "format": "PQ",
    "lyric": "[00:01.00]..."
  }
}
```