# 酷狗音乐
**请求方式:** GET
**接口地址:** https://api.hk0.cc/api/kugou
**接口描述:** 酷狗音乐搜索与解析: 支持关键词搜索、按 hash 取详情与播放直链、解析酷狗分享链接、获取 LRC 歌词; keyword+n 可直接出单曲(优先 xcvts 上游, 常含 flac 无损, 失败回退本地). 付费/版权曲目返回元数据并标记 pay=true.
## 请求参数
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| type | string | query | 可选 | — | — | 操作类型: search 搜索 / song 歌曲详情 / url 仅返回直链 / lyric 仅返回歌词; 不传按参数自动判断(hash 优先于 keyword) |
| keyword | string | query | 可选 | — | — | 搜索关键词, 如 周杰伦、国歌; type=search 时必填。也接受 msg/name/q/w/s |
| hash | string | query | 可选 | — | — | 歌曲 hash (32 位十六进制), 搜索结果的 id 字段即为 hash。也接受 id/mid |
| url | string | query | 可选 | — | — | 酷狗歌曲分享链接, 自动提取其中的 hash |
| page | int | query | 可选 | — | — | 页码, 默认 1, 最大 100 |
| limit | int | query | 可选 | — | — | 每页数量, 默认 10, 最大 30 |
| lyric | int | query | 可选 | — | — | 传 0 不返回歌词 (默认 1 返回) |
| fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |
| n | int | query | 可选 | — | — | 选曲序号: 配合 keyword 使用, 传 n=1 直接返回第 1 首的完整信息(含直链与歌词)。优先走 xcvts 上游(常见 flac 无损), 失败自动回退本地酷狗 |
## 返回示例
```json
{
"code": 200,
"msg": "success",
"data": {
"platform": "kugou",
"keyword": "国歌",
"page": 1,
"limit": 1,
"total": 369,
"list": [
{
"platform": "kugou",
"id": "041076fb1243213151b85a315c5bd431",
"name": "义勇军进行曲 (合唱版)",
"artist": "中国人民解放军军乐团",
"album": "标准礼仪曲集",
"duration": 50,
"cover": "https://imge.kugou.com/stdmusic/500/1078202.jpg",
"lossless_available": true,
"web_url": "https://www.kugou.com/song/#hash=041076fb1243213151b85a315c5bd431&album_id=1078202"
}
]
}
}
```