网易云音乐 API 接口文档

登录相关

手机号登录
GET /login/cellphone

请求参数：

参数名 必选 类型 说明
phone 是 string 手机号码
password 是 string 密码

请求示例：

/login/cellphone?phone=13xxx&password=xxxxx
邮箱登录
GET /login/email

请求参数：

参数名 必选 类型 说明
email 是 string 邮箱地址
password 是 string 密码

请求示例：

/login/email?email=xxx@qq.com&password=xxxxx
二维码key生成
GET /login/qr/key

请求示例：

/login/qr/key
二维码生成
GET /login/qr/create

请求参数：

参数名 必选 类型 说明
key 是 string 由第一个接口生成的key

请求示例：

/login/qr/create?key=xxxxx
二维码检测扫码状态
GET /login/qr/check

请求参数：

参数名 必选 类型 说明
key 是 string 由第一个接口生成的key

轮询此接口获取扫码状态（建议每3秒轮询一次，当获取到800或803状态码时停止轮询），返回状态码说明:

状态码 说明
800 二维码过期
801 等待扫码
802 待确认
803 授权登录成功

请求示例：

/login/qr/check?key=xxxxx

用户相关

获取用户详情
GET /user/detail

请求参数：

参数名 必选 类型 说明
uid 是 number 用户ID

请求示例：

/user/detail?uid=32953014
获取用户歌单
GET /user/playlist

请求参数：

参数名 必选 类型 说明
uid 是 number 用户ID
limit 否 number 返回数量限制，默认为30
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/user/playlist?uid=32953014&limit=30&offset=0
获取用户喜欢的音乐ID列表
GET /likelist

请求参数：

参数名 必选 类型 说明
uid 是 number 用户ID

请求示例：

/likelist?uid=32953014
获取用户关注列表
GET /user/follows

请求参数：

参数名 必选 类型 说明
uid 是 number 用户ID
limit 否 number 返回数量限制，默认为30
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/user/follows?uid=32953014&limit=30&offset=0

歌曲相关

获取音乐URL - 新版
GET /song/url/v1

请求参数：

参数名 必选 类型 说明
id 是 number 音乐ID
level 否 string 音质等级，分为 standard => 标准，higher => 较高，exhigh=>极高，lossless=>无损，hires=>Hi-Res，默认为 standard

请求示例：

/song/url/v1?id=33894312&level=exhigh
获取歌曲详情
GET /song/detail

请求参数：

参数名 必选 类型 说明
ids 是 string 音乐ID，多个用逗号分隔

请求示例：

/song/detail?ids=347230,347231
获取歌词
GET /lyric

请求参数：

参数名 必选 类型 说明
id 是 number 音乐ID

请求示例：

/lyric?id=33894312
喜欢音乐
GET /like

请求参数：

参数名 必选 类型 说明
id 是 number 音乐ID
like 否 boolean 布尔值，默认为 true 即喜欢，若传 false 则取消喜欢

请求示例：

/like?id=347230

歌单相关

获取歌单详情
GET /playlist/detail

请求参数：

参数名 必选 类型 说明
id 是 number 歌单ID

请求示例：

/playlist/detail?id=24381616
获取歌单所有歌曲
GET /playlist/track/all

请求参数：

参数名 必选 类型 说明
id 是 number 歌单ID
limit 否 number 限制获取歌曲的数量，默认值为全部
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/playlist/track/all?id=24381616&limit=10&offset=0
获取精品歌单
GET /top/playlist/highquality

请求参数：

参数名 必选 类型 说明
cat 否 string 歌单分类，默认为全部
limit 否 number 取出歌单数量，默认为20
before 否 number 分页参数,取上一页最后一个歌单的 updateTime 获取下一页数据

请求示例：

/top/playlist/highquality?cat=华语&limit=20
获取相关歌单推荐
GET /related/playlist

请求参数：

参数名 必选 类型 说明
id 是 number 歌单ID

请求示例：

/related/playlist?id=24381616

歌手相关

获取歌手详情
GET /artist/detail

请求参数：

参数名 必选 类型 说明
id 是 number 歌手ID

请求示例：

/artist/detail?id=6452
获取歌手热门歌曲
GET /artist/top/song

请求参数：

参数名 必选 类型 说明
id 是 number 歌手ID

请求示例：

/artist/top/song?id=6452
获取歌手专辑
GET /artist/album

请求参数：

参数名 必选 类型 说明
id 是 number 歌手ID
limit 否 number 返回数量限制，默认为30
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/artist/album?id=6452&limit=30&offset=0
获取歌手MV
GET /artist/mv

请求参数：

参数名 必选 类型 说明
id 是 number 歌手ID
limit 否 number 返回数量限制，默认为30
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/artist/mv?id=6452&limit=30&offset=0
获取歌手描述
GET /artist/desc

请求参数：

参数名 必选 类型 说明
id 是 number 歌手ID

请求示例：

/artist/desc?id=6452

专辑相关

获取专辑内容
GET /album

请求参数：

参数名 必选 类型 说明
id 是 number 专辑ID

请求示例：

/album?id=32311
获取专辑详情
GET /album/detail/dynamic

请求参数：

参数名 必选 类型 说明
id 是 number 专辑ID

请求示例：

/album/detail/dynamic?id=32311
获取最新专辑
GET /album/newest

请求示例：

/album/newest
专辑动态信息
GET /album/sub

请求参数：

参数名 必选 类型 说明
id 是 number 专辑ID
t 是 number 1 为收藏，0 为取消收藏

请求示例：

/album/sub?id=32311&t=1

MV相关

获取MV详情
GET /mv/detail

请求参数：

参数名 必选 类型 说明
mvid 是 number MV的ID

请求示例：

/mv/detail?mvid=5436712
获取MV播放地址
GET /mv/url

请求参数：

参数名 必选 类型 说明
id 是 number MV的ID
r 否 number 分辨率，默认1080，可从 /mv/detail 接口获取分辨率列表

请求示例：

/mv/url?id=5436712&r=1080
获取最新MV
GET /mv/first

请求参数：

参数名 必选 类型 说明
limit 否 number 取出数量，默认为30
area 否 string 地区，可选值为：全部、内地、港台、欧美、日本、韩国，默认为全部

请求示例：

/mv/first?limit=10&area=内地
获取MV排行榜
GET /top/mv

请求参数：

参数名 必选 类型 说明
limit 否 number 取出数量，默认为30
offset 否 number 偏移数量，用于分页，默认为0
area 否 string 地区，可选值为：全部、内地、港台、欧美、日本、韩国，默认为全部

请求示例：

/top/mv?limit=10&area=内地

视频相关

获取视频详情
GET /video/detail

请求参数：

参数名 必选 类型 说明
id 是 string 视频ID

请求示例：

/video/detail?id=89ADDE33C0AAE8EC14B99F6750DB954D
获取视频播放地址
GET /video/url

请求参数：

参数名 必选 类型 说明
id 是 string 视频ID
resolution 否 number 分辨率，默认1080

请求示例：

/video/url?id=89ADDE33C0AAE8EC14B99F6750DB954D&resolution=1080
获取推荐视频
GET /video/timeline/recommend

请求参数：

参数名 必选 类型 说明
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/video/timeline/recommend?offset=0
获取视频标签列表
GET /video/group/list

请求示例：

/video/group/list
获取视频分类列表
GET /video/category/list

请求示例：

/video/category/list

评论相关

获取评论
GET /comment/new

请求参数：

参数名 必选 类型 说明
id 是 number 资源ID
type 是 number 资源类型，0: 歌曲 1: MV 2: 歌单 3: 专辑 4: 电台节目 5: 视频 6: 动态
pageNo 否 number 分页参数，第几页，默认1
pageSize 否 number 分页参数，每页多少条，默认20
sortType 否 number 排序方式，1:按推荐排序，2:按热度排序，3:按时间排序

请求示例：

/comment/new?id=186016&type=0&pageNo=1&pageSize=20&sortType=3
发送/删除评论
GET /comment

请求参数：

参数名 必选 类型 说明
t 是 number 操作类型，1: 发送评论 2: 回复评论 0: 删除评论
type 是 number 资源类型，0: 歌曲 1: MV 2: 歌单 3: 专辑 4: 电台节目 5: 视频 6: 动态
id 是 number 资源ID
content 是 string 评论内容
commentId 否 number 回复的评论ID（回复评论时必填）

请求示例：

/comment?t=1&type=0&id=186016&content=真好听
给评论点赞
GET /comment/like

请求参数：

参数名 必选 类型 说明
id 是 number 资源ID
cid 是 number 评论ID
t 是 number 是否点赞，1: 点赞 0: 取消点赞
type 是 number 资源类型，0: 歌曲 1: MV 2: 歌单 3: 专辑 4: 电台节目 5: 视频 6: 动态

请求示例：

/comment/like?id=186016&cid=123456&t=1&type=0

电台相关

获取电台节目
GET /dj/program

请求参数：

参数名 必选 类型 说明
rid 是 number 电台ID
limit 否 number 返回数量，默认为30
offset 否 number 偏移数量，用于分页，默认为0
asc 否 boolean 排序方式，默认为 false（新 => 老）设置 true 可改为 老 => 新

请求示例：

/dj/program?rid=336355127&limit=30
获取电台详情
GET /dj/detail

请求参数：

参数名 必选 类型 说明
rid 是 number 电台ID

请求示例：

/dj/detail?rid=336355127
获取推荐电台
GET /dj/recommend

请求参数：

参数名 必选 类型 说明
type 否 number 电台类型，默认为0（0: 所有类型）

请求示例：

/dj/recommend?type=2
获取电台分类
GET /dj/catelist

请求示例：

/dj/catelist
订阅/取消订阅电台
GET /dj/sub

请求参数：

参数名 必选 类型 说明
rid 是 number 电台ID
t 是 number 1: 订阅，0: 取消订阅

请求示例：

/dj/sub?rid=336355127&t=1

云盘相关

获取云盘数据
GET /user/cloud

请求参数：

参数名 必选 类型 说明
limit 否 number 返回数量，默认为30
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/user/cloud?limit=30&offset=0
云盘上传
GET /cloud

请求参数：

参数名 必选 类型 说明
songFile 是 file 要上传的音乐文件

请求示例：

/cloud?songFile=file
云盘歌曲删除
GET /user/cloud/del

请求参数：

参数名 必选 类型 说明
id 是 number 云盘歌曲ID

请求示例：

/user/cloud/del?id=123456
云盘数据详情
GET /user/cloud/detail

请求参数：

参数名 必选 类型 说明
id 是 number 云盘歌曲ID

请求示例：

/user/cloud/detail?id=123456

云贝相关

云贝签到
GET /yunbei/sign

请求示例：

/yunbei/sign
云贝账户信息
GET /yunbei/info

请求示例：

/yunbei/info
云贝所有任务
GET /yunbei/tasks

请求示例：

/yunbei/tasks
云贝完成任务
GET /yunbei/task/finish

请求参数：

参数名 必选 类型 说明
userTaskId 是 number 任务ID

请求示例：

/yunbei/task/finish?userTaskId=123456
云贝收支记录
GET /yunbei/tasks/receipt

请求参数：

参数名 必选 类型 说明
limit 否 number 返回数量，默认为10
offset 否 number 偏移数量，用于分页，默认为0

请求示例：

/yunbei/tasks/receipt?limit=10&offset=0

VIP相关

VIP信息
GET /vip/info

请求示例：

/vip/info
VIP成长值
GET /vip/growth/get

请求示例：

/vip/growth/get
VIP任务
GET /vip/tasks

请求示例：

/vip/tasks
VIP成长值获取记录
GET /vip/growth/records

请求示例：

/vip/growth/records
VIP会员等级
GET /vip/level

请求示例：

/vip/level

其他接口

首页-发现
GET /homepage/block/page

请求示例：

/homepage/block/page
Banner
GET /banner

请求参数：

参数名 必选 类型 说明
type 否 number 资源类型，0: PC，1: Android，2: iPhone，3: iPad，默认为0

请求示例：

/banner?type=0
音乐日历
GET /calendar

请求参数：

参数名 必选 类型 说明
startTime 否 number 开始时间时间戳
endTime 否 number 结束时间时间戳

请求示例：

/calendar?startTime=1606752000000&endTime=1609430399999
排行榜
GET /toplist

请求示例：

/toplist
所有榜单内容摘要
GET /toplist/detail

请求示例：

/toplist/detail
每日推荐歌单
GET /recommend/resource

请求示例：

/recommend/resource
每日推荐歌曲
GET /recommend/songs

请求示例：

/recommend/songs