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