自从上一版开源过后到现在音乐接口的调用量已经达到了快100W,但是最近由于网易云的更新,导致部分接口不能使用,最近在工作之余抽出时间把API重写。
本次API版本不再使用PHP,使用Java,相比以前速度更快(毕竟我是撸Java的,不会PHP),前期不考虑开源,当API完善差不多的时候再考虑开源,如有需要请加群联系我。
注意!!!
- 禁止私自商业用途,如有发现直接禁IP和域名
- 当前版本不再进行维护,新版进行继续维护,
- 最新版本文档地址 https://www.bzqll.com/2019/04/318.html https://messoer.github.io/mess-api-doc
最新更新:
2018.11.11更新:
- 优化QQ音乐搜索,支持音乐/专辑/歌单/歌词/用户/MV模糊搜索
- 开启缓存优化
2018.11.08更新:
- 增加网易云音乐MV排行榜接口
2018.11.07更新:
- 更新ONE一个接口
- 增加QQ音乐热门歌单分类接口
- 增加QQ音乐热门歌单接口
- 增加QQ音乐热门MV分类接口
- 增加QQ音乐热门MV接口
2018.11.04更新:
- 站点开启https
- 增加ONE 一个接口,需要联系我
2018.11.01更新:
- 优化网易云搜索:支持音乐/专辑/歌词/歌单/视频/用户/歌手/电台搜索,支持分页加载
- 优化音乐显示歌手名称不全
2018.10.30更新:
- 增加支持热门歌单和精品歌单支持
2018.10.27日更新:
- 增加支持QQ音乐解析音乐和MV,支持跨域访问
- 支持获取请求源数据(未开放,如需要进群联系我)
- 最近根据反馈开发酷狗音乐、虾米音乐、百度音乐接口
2018.10.21日更新:
- API全新版本,原有API接口不再维护,新版使用GET请求方式通过URL解析音乐,更加便捷
- 新版音乐增加MV解析,多音质解析,源接口调用(暂未开放,测试中)
- 最近两周上线QQ音乐、酷狗音乐、虾米音乐、百度音乐接口
缓存提示
- 默认开启缓存,毕竟音乐的更新频率不是很频繁,建议使用缓存,
- 获取数据的URL参数不变动的情况下重复访问则使用的是缓存
- 缓存关闭方案,在URL后跟随动态获取的时间戳,例如:https://api.itooi.cn/music/netease/songList?key=579621905&id=3778678&limit=10&offset=0×tamp=1541934655
1. 敲黑板,看重点
好多人在群里一直问id从哪获取,这里我举例子
1.歌单ID
#此处的2483495328就是歌单ID
网易云歌单URL地址: https://music.163.com/#/playlist?id=2483495328#此处的5374436553就是歌单ID
QQ音乐歌单URL地址: https://y.qq.com/n/yqq/playlist/5374436553.html
2.音乐ID
#此处的449818741就是音乐ID
网易云音乐URL地址: https://music.163.com/#/song?id=449818741#此处的002E3MtF0IAMMY就是音乐ID
QQ音乐URL地址: https://y.qq.com/n/yqq/song/002E3MtF0IAMMY.html
等等很多ID都差不多是这样子,废话不再多说,直接上说明文档
2. 当前支持平台
- 网易云音乐API文档 https://www.bzqll.com/2018/10/39.html
- QQ音乐API文档 https://www.bzqll.com/2019/01/262.html
- 酷狗音乐API文档 https://www.bzqll.com/2019/01/259.html
- 酷我音乐API文档 https://www.bzqll.com/2019/04/313.html
No.1 歌单获取
请求URL: https://api.itooi.cn/music/netease/songList
请求示例: https://api.itooi.cn/music/netease/songList?key=579621905&id=3778678&limit=10&offset=0
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 网易云歌单的ID | 无 |
limit | × | 请求数量 | 默认为 100 |
由于网易云本身不支持分页,此接口暂不支持分页获取
No.2 搜索音乐/专辑/歌词/歌单/MV/用户/歌手/电台搜索
请求URL: https://api.itooi.cn/music/netease/search
请求示例: https://api.itooi.cn/music/netease/search?key=579621905&s=我喜欢上你内心时的活动&type=song&limit=100&offset=0
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
s | × | 搜索关键词 | 详细见下面说明 |
type | × | 搜索类型 | 默认为 song |
limit | × | 请求数量 | 默认为 100 |
offset | × | 分页 | 默认第1页 |
说明 : 当前搜索类型支持:
- 音乐搜索:type=song
- 歌手搜索:type=singer
- 专辑搜索:type=album
- 歌单搜索:type=list
- 视频搜索:type=video
- 电台搜索:type=radio
- 用户搜索:type=user
- 歌词搜索:type=lrc
No.3 获取专辑详情
请求URL: https://api.itooi.cn/music/netease/album
请求示例: https://api.itooi.cn/music/netease/album?key=579621905&id=32311
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 专辑ID | 无 |
No.4 获取音乐详情
请求URL: https://api.itooi.cn/music/netease/song
请求示例: https://api.itooi.cn/music/netease/song?key=579621905&id=526307800
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 无 |
No.5 获取音乐播放地址
请求URL: https://api.itooi.cn/music/netease/url
请求示例: https://api.itooi.cn/music/netease/url?key=579621905&id=526307800&br=999000
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 无 |
br | √ | 码率 | 默认最大码率 即最高音质 999000 |
说明: 码率类型:128000 192000 320000 999000
No.6 获取音乐歌词
请求URL: https://api.itooi.cn/music/netease/lrc
请求示例: https://api.itooi.cn/music/netease/lrc?key=579621905&id=526307800
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 默认获取翻译歌词 |
No.6 获取音乐图片
请求URL: https://api.itooi.cn/music/netease/pic
请求示例: https://api.itooi.cn/music/netease/pic?key=579621905&id=526307800
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 默认获取最大图 |
No.7 获取MV信息
请求URL: https://api.itooi.cn/music/netease/mv
请求示例: https://api.itooi.cn/music/netease/mv?key=579621905&id=5965802
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | MV ID | 默认获取MP4格式 |
No.8 获取MV播放地址
请求URL: https://api.itooi.cn/music/netease/mvUrl
请求示例: https://api.itooi.cn/music/netease/mvUrl?key=579621905&id=5965802&r=1080
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | MVID | |
r | × | 视频格式 | 默认1080 |
说明: 视频大小类型:1080 720 480 240
No.9 获取精品歌单
请求URL: https://api.itooi.cn/music/netease/highQualitySongList
请求示例: https://api.itooi.cn/music/netease/highQualitySongList?key=579621905&cat=全部&limit=100
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
cat | × | 歌单分类 | 默认全部 |
limit | × | 获取条数 | 默认100 |
lasttime | × | 上次返回的结果的lasttime值 |
No.10 获取热门歌单
请求URL: https://api.itooi.cn/music/netease/hotSongList
请求示例: https://api.itooi.cn/music/netease/hotSongList?key=579621905&cat=全部&limit=100&offset=0
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
cat | × | 歌单分类 | 默认全部 |
limit | × | 获取条数 | 默认100 |
offset | × | 分页 | 默认0 |
order | × | 分别对应最新和最热 | 可选值为 ‘new’ 和 ‘hot’,默认为 ‘hot’ |
No.11 获取MV排行榜
请求URL: https://api.itooi.cn/music/netease/topMvList
请求示例: https://api.itooi.cn/music/netease/topMvList?key=579621905&limit=10&offset=0
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
limit | × | 获取条数 | 默认100 |
offset | × | 分页 | 默认0 |
4. QQ音乐
No.1 歌单获取
请求URL: https://api.itooi.cn/music/tencent/songList
请求示例: https://api.itooi.cn/music/tencent/songList?key=579621905&id=1147906982
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 歌单的ID | 无 |
No.2 搜索音乐/专辑/歌单/MV/歌词/用户
请求URL: https://api.itooi.cn/music/tencent/search
请求示例: https://api.itooi.cn/music/tencent/search?key=579621905&s=123&limit=100&offset=0&type=song
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
s | √ | 搜索关键词 | 无 |
type | √ | 搜索类型 | 默认为搜索音乐 |
limit | × | 搜索结果数量 | 默认为 100 |
offset | × | 搜索结果页数 | 默认为第1页 |
说明 : 当前搜索类型支持:
- 音乐搜索:type=song
- 专辑搜索:type=album
- 歌单搜索:type=list (QQ音乐限制歌单每页最多查询50条)
- MV搜索:type=mv
- 用户搜索:type=user
- 歌词搜索:type=lrc
No.3 获取专辑详情
请求URL: https://api.itooi.cn/music/tencent/album
请求示例: https://api.itooi.cn/music/tencent/album?key=579621905&id=000i3LVu28zIG2
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 专辑ID | 无 |
No.4 获取音乐详情
请求URL: https://api.itooi.cn/music/tencent/song
请求示例: https://api.itooi.cn/music/tencent/song?key=579621905&id=001fXNWa3t8EQQ
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 无 |
No.5 获取音乐播放地址
请求URL: https://api.itooi.cn/music/tencent/url
请求示例: https://api.itooi.cn/music/tencent/url?key=579621905&id=001fXNWa3t8EQQ&br=192
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 无 |
br | √ | 码率 | 默认最大码率 即最高音质 320 |
说明: 码率类型:24 48 96 128 192 320
No.6 获取音乐歌词
请求URL: https://api.itooi.cn/music/tencent/lrc
请求示例: https://api.itooi.cn/music/tencent/lrc?key=579621905&id=001fXNWa3t8EQQ
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 默认获取翻译歌词 |
No.6 获取音乐图片
请求URL: https://api.itooi.cn/music/tencent/pic
请求示例: https://api.itooi.cn/music/tencent/pic?key=579621905&id=001fXNWa3t8EQQ
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | 音乐ID | 默认获取最大图 |
No.7 获取MV信息
请求URL: https://api.itooi.cn/music/tencent/mv
请求示例: https://api.itooi.cn/music/tencent/mv?key=579621905&id=m00238resnh
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | MV ID | 默认获取MP4格式 |
No.8 获取MV播放地址
请求URL: https://api.itooi.cn/music/tencent/mvUrl
请求示例: https://api.itooi.cn/music/tencent/mvUrl?key=579621905&id=m00238resnh&r=4
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
id | √ | MVID | |
r | × | 视频格式 | 默认 3:720 |
说明: 视频大小类型:1:360 2:480 3:720 4:1080
No.9 获取热门歌单分类接口
请求URL: https://api.itooi.cn/music/tencent/songListCategory
请求示例: https://api.itooi.cn/music/tencent/songListCategory?key=579621905
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
说明: 用于获取热门歌单使用
No.10 获取热门歌单
请求URL: https://api.itooi.cn/music/tencent/hotSongList
请求示例: https://api.itooi.cn/music/tencent/hotSongList?key=579621905&categoryId=10000000&sortId=3&limit=60
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
categoryId | X | 分类ID,通过上面的分类接口获取 | 默认获取全部 |
sortId | X | 排序ID 1 默认 2 最新 3 热门 4 评分 | 默认按照热门排序 |
limit | X | 获取数量 | 默认60 最大值60 |
No.11 获取热门MV分类接口
请求URL: https://api.itooi.cn/music/tencent/mvListCategory
请求示例: https://api.itooi.cn/music/tencent/mvListCategory?key=579621905
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
说明: 用于获取热门MV使用
No.12 获取热门MV
请求URL: https://api.itooi.cn/music/tencent/hotMvList
请求示例: https://api.itooi.cn/music/tencent/hotMvList?key=579621905&year=0&tag=0&area=0&limit=100&offset=0
参数说明 | 是否必须 | 说明 | 默认值 |
---|---|---|---|
key | √ | 请求秘钥,QQ群号 | 579621905 |
tag | X | 标签分类 | 默认0 全部 值通过上面的分类接口获取 |
area | X | 地区分类 | 默认0 全部 值通过上面的分类接口获取 |
year | X | 年份分类 | 默认0 全部 值通过上面的分类接口获取 |
offset | X | 分页 | 默认 0 |
limit | X | 获取数量 | 默认100 |
目前已更新接口暂时就这么多,抽时间将继续完善和开发其他平台的音乐获取,如有需求请QQ群联系我。