接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
type | string | query | 可选 | — | — | 操作类型: search 搜索 / song 歌曲详情(含直链与歌词) / url 仅返回直链 / lyric 仅返回歌词; 不传时按参数自动判断(id 优先, keyword+n 出单曲) |
keyword | string | query | 可选 | — | — | 搜索关键词, 如 周杰伦、晴天、卡农; type=search 时必填。也接受 s/msg/name/q/w/text |
id | string | query | 可选 | — | — | 网易云歌曲 ID, 如晴天 186016。也接受 contentId/cid/mid/songid; id 类接口(type=song/url/lyric)传纯数字关键词会自动当 id |
url | string | query | 可选 | — | — | 网易云歌曲分享链接, 自动提取其中的歌曲 ID |
page | int | query | 可选 | — | — | 页码, 默认 1 |
limit | int | query | 可选 | — | — | 每页数量, 默认 10, 最大 30。也接受 pageSize/count |
br | string | query | 可选 | — | — | 音质: 1 无损 / 2 320k / 3 192k / 4 128k, 默认 4。也接受 quality/level; 付费/版权曲在免费源普遍无直链 |
lyric | int | query | 可选 | — | — | 传 0 不返回歌词 (默认 1 返回, 含翻译 tlyric) |
fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |
n | int | query | 可选 | — | — | 选曲序号: 配合 keyword 使用, 传 n=1 直接返回第 1 首完整信息(含直链与歌词)。也接受 index/num |