接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
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 无损), 失败自动回退本地酷狗 |