qq-music-api/docs at main · Rain120/qq-music-api

Name	Name	Last commit message	Last commit date
parent directory ..
.nojekyll	.nojekyll
README.md	README.md
_coverpage.md	_coverpage.md
_navbar.md	_navbar.md
chao.png	chao.png
index.html	index.html
logo.png	logo.png
sw.js	sw.js

QQ Music API

!> QQ音乐API koa2 版本, 通过Web网页版请求QQ音乐接口数据, 有问题请提 issue, 或者你有其他想法欢迎PR.

API结构图

API接口

!> koa2 接口说明(参数, 地址, 效果图)

新特性

支持自定义设置cookie

!> 2020-01-23 新增, 只需要配置 config/user-info.js 中的 cookies 字段就会在发送请求时带上你的 cookies。

格式化自定义的 cookie

特性提示支持

获取 Cookie

!> 目前只支持用户自己从 QQ音乐 获取获取 Cookie, 如何获取 Cookie, 登录 QQ音乐, 然后 F12, 找到 Network, 随便找一个获取数据的接口, 复制接口中 request headers 中的 Cookie 即可。

接口说明: 调用此接口, 可获取自己在 config/user-info.js 配置的 Cookie 被格式化的结果

配置信息如下:

const userInfo = {
	loginUin: 'qq号码',
	cookie: '',
}

接口地址: /user/getCookie

调用例子: /user/getCookie

示例截图:

获取QQ音乐产品的下载地址

接口说明: 调用此接口, 可获取QQ音乐标准产品下载链接

接口地址: /downloadQQMusic

调用例子: /downloadQQMusic

示例截图:

获取歌单分类

接口说明: 调用此接口, 可获取歌单分类, 包含category信息

接口地址: /getSongListCategories

调用例子: /getSongListCategories

SortID

sortId: 1, sortName: 默认
sortId: 2, sortName: 最新
sortId: 3, sortName: 最热
sortId: 4, sortName: 评分
sortId: 5, sortName: none

歌单分类(categoryId & categoryName)

1. 热门

1.1
  "categoryId": 10000000,
  "categoryName": 全部,

2. 语种

2.1
  "categoryId": 167,
  "categoryName": "英语",
2.2
  "categoryId": 168,
  "categoryName": "韩语",
2.3
  "categoryId": 166,
  "categoryName": "粤语",
2.4
  "categoryId": 169,
  "categoryName": "日语",
2.5
  "categoryId": 170,
  "categoryName": "小语种",
2.6
  "categoryId": 203,
  "categoryName": "闽南语",
2.7
  "categoryId": 204,
  "categoryName": "法语",
2.8
  "categoryId": 205,
  "categoryName": "拉丁语",

3. 流派

3.1
  "categoryId": 6,
  "categoryName": "流行",
3.2
  "categoryId": 15,
  "categoryName": "轻音乐",
3.3
  "categoryId": 11,
  "categoryName": "摇滚",
3.4
  "categoryId": 28,
  "categoryName": "民谣",
3.5
  "categoryId": 8,
  "categoryName": "R&B",
3.6
  "categoryId": 153,
  "categoryName": "嘻哈",
3.7
  "categoryId": 24,
  "categoryName": "电子",
3.8
  "categoryId": 27,
  "categoryName": "古典",
3.9
  "categoryId": 18,
  "categoryName": "乡村",
3.10
  "categoryId": 22,
  "categoryName": "蓝调",
3.11
  "categoryId": 21,
  "categoryName": "爵士",
3.12
  "categoryId": 164,
  "categoryName": "新世纪",
3.13
  "categoryId": 25,
  "categoryName": "拉丁",
3.14
  "categoryId": 218,
  "categoryName": "后摇",
3.15
  "categoryId": 219,
  "categoryName": "中国传统",
3.16
  "categoryId": 220,
  "categoryName": "世界音乐",

4. 主题

4.1
  "categoryId": 39,
  "categoryName": "ACG",
4.2
  "categoryId": 136,
  "categoryName": "经典",
4.3
  "categoryId": 146,
  "categoryName": "网络歌曲",
4.4
  "categoryId": 133,
  "categoryName": "影视",
4.5
  "categoryId": 141,
  "categoryName": "KTV热歌",
4.6
  "categoryId": 131,
  "categoryName": "儿歌",
4.7
  "categoryId": 145,
  "categoryName": "中国风",
4.8
  "categoryId": 194,
  "categoryName": "古风",
4.9
  "categoryId": 148,
  "categoryName": "情歌",
4.10
  "categoryId": 196,
  "categoryName": "城市",
4.11
  "categoryId": 197,
  "categoryName": "现场音乐",
4.12
  "categoryId": 199,
  "categoryName": "背景音乐",
4.13
  "categoryId": 200,
  "categoryName": "佛教音乐",
4.14
  "categoryId": 201,
  "categoryName": "UP主",
4.15
  "categoryId": 202,
  "categoryName": "乐器",
4.16
  "categoryId": 14,
  "categoryName": "DJ",

5. 心情

5.1
  "categoryId": 52,
  "categoryName": "伤感",
5.2
  "categoryId": 122,
  "categoryName": "安静",
5.3
  "categoryId": 117,
  "categoryName": "快乐",
5.4
  "categoryId": 116,
  "categoryName": "治愈",
5.5
  "categoryId": 125,
  "categoryName": "励志",
5.6
  "categoryId": 59,
  "categoryName": "甜蜜",
5.7
  "categoryId": 55,
  "categoryName": "寂寞",
5.8
  "categoryId": 126,
  "categoryName": "宣泄",
5.9
  "categoryId": 68,
  "categoryName": "思念",

6. 场景

6.1
  "categoryId": 78,
  "categoryName": "睡前",
6.2
  "categoryId": 102,
  "categoryName": "夜店",
6.3
  "categoryId": 101,
  "categoryName": "学习",
6.4
  "categoryId": 99,
  "categoryName": "运动",
6.5
  "categoryId": 99,
  "categoryName": "运动",
6.6
  "categoryId": 76,
  "categoryName": "约会",
6.7
  "categoryId": 94,
  "categoryName": "工作",
6.8
  "categoryId": 81,
  "categoryName": "旅行",
6.9
  "categoryId": 103,
  "categoryName": "派对",
6.10
  "categoryId": 222,
  "categoryName": "婚礼",
6.11
  "categoryId": 223,
  "categoryName": "咖啡馆",
6.12
  "categoryId": 224,
  "categoryName": "跳舞",
6.13
  "categoryId": 16,
  "categoryName": "校园",

示例截图:

获取歌单列表

接口说明: 调用此接口, 可获取歌单列表

参数列表:

必选参数
- categoryId: 类别id, 详见 /getSongListCategories
可选参数
- page: 当前页数, 默认为1
- limit: 取出歌单数量, 默认为 20
- sortId: 最新, 最热,评分, 默认为5

接口地址: /getSongLists

调用例子: /getSongLists?categoryId=10000000

示例截图:

获取歌单列表

批量获取歌单列表

接口说明: 调用此接口, 可批量获取歌单列表

参数列表:

必选参数
- categoryIds: 类别id列表, 详见 /getSongListCategories
可选参数
- page: 当前页数, 默认为1
- limit: 取出歌单数量, 默认为 20
- sortId: 最新, 最热,评分, 默认为5

接口地址: /batchGetSongLists

调用例子: /batchGetSongLists

{
  "limit": 19,
  "page": 0,
  "sortId": 5,
  "categoryIds": [167, 168]
}

示例截图:

批量获取歌单列表

获取歌单列表-带参数

获取歌单详情

接口说明: 调用此接口, 可获取歌单详情

参数列表:

必选参数
- disstid: 歌单id

接口地址: /getSongListDetail

调用例子: /getSongListDetail?disstid=7011264340

示例截图:

获取MV标签

接口说明: 调用此接口, 可获取MV标签

接口地址: /getMvByTag

调用例子: /getMvByTag

示例截图:

获取MV播放信息

接口说明: 调用此接口, 可获取MV播放信息

参数列表:

必选参数
- vid: video id

接口地址: /getMvPlay

调用例子: /getMvPlay?vid=u00222le4ox

示例截图:

获取歌手MV

接口说明: 调用此接口, 可获取歌手MV

参数列表:

必选参数
- singermid: 歌手id
可选参数
- order: 当前MV类型, 默认为time
  - listen: 歌手专辑音乐MV
  - time: 粉丝上传MV视频
- limit: 取出歌单数量, 默认为5

接口地址: /getSingerMV

调用例子: /getSingerMV?singermid=0025NhlN2yWrP4&order=all&limit=5

示例截图:

获取歌手热门歌曲

接口说明: 调用此接口, 可获取歌手热门歌曲

参数列表:

必选参数
- singermid: 歌手id
可选参数
- page: 页数, 默认为0
- limit: 取出歌单数量, 默认为5

接口地址: /getSingerHotsong

调用例子: /getSingerHotsong?singermid=0025NhlN2yWrP4&limit=10&page=2

示例截图:

获取相似歌手

接口说明: 调用此接口, 可获取相似歌手

参数列表:

必选参数
- singermid: 歌手id

接口地址: /getSimilarSinger

调用例子: /getSimilarSinger?singermid=0025NhlN2yWrP4

示例截图:

获取歌手信息

接口说明: 调用此接口, 可获取歌手信息

参数列表:

必选参数
- singermid: 歌手id

接口地址: /getSingerDesc

调用例子: /getSingerDesc?singermid=0025NhlN2yWrP4

示例截图:

获取歌手列表

接口说明: 调用此接口, 可获取歌手列表

参数列表:

可选参数

area 默认是 -100

  "id": -100,
  "name": "全部"
  "id": 200,
  "name": "内地"
  
  "id": 2,
  "name": "港台"
  
  "id": 5,
  "name": "欧美"
  
  "id": 4,
  "name": "日本"
  
  "id": 3,
  "name": "韩国"
  
  "id": 6,
  "name": "其他"

genre 默认是 -100

"id": -100,
"name": "全部"

"id": 1,
"name": "流行"

"id": 6,
"name": "嘻哈"

"id": 2,
"name": "摇滚"

"id": 4,
"name": "电子"

"id": 3,
"name": "民谣"

"id": 8,
"name": "R&B"

"id": 10,
"name": "民歌"

"id": 9,
"name": "轻音乐"

"id": 5,
"name": "爵士"

"id": 14,
"name": "古典"

"id": 25,
"name": "乡村"

"id": 20,
"name": "蓝调"

index 默认是 -100

"id": -100,
"name": "热门"

"id": 1,
"name": "A"

"id": 2,
"name": "B"

"id": 3,
"name": "C"

"id": 4,
"name": "D"

"id": 5,
"name": "E"

"id": 6,
"name": "F"

"id": 7,
"name": "G"

"id": 8,
"name": "H"

"id": 9,
"name": "I"

"id": 10,
"name": "J"

"id": 11,
"name": "K"

"id": 12,
"name": "L"

"id": 13,
"name": "M"

"id": 14,
"name": "N"

"id": 15,
"name": "O"

"id": 16,
"name": "P"

"id": 17,
"name": "Q"

"id": 18,
"name": "R"

"id": 19,
"name": "S"

"id": 20,
"name": "T"

"id": 21,
"name": "U"

"id": 22,
"name": "V"

"id": 23,
"name": "W"

"id": 24,
"name": "X"

"id": 25,
"name": "Y"

"id": 26,
"name": "Z"

"id": 27,
"name": "#"

sex 默认是 -100

"id": -100,
"name": "全部"

"id": 0,
"name": "男"

"id": 1,
"name": "女"

"id": 2,
"name": "组合"

接口地址: /getSingerList

调用例子: /getSingerList 调用例子: /getSingerList?area=200&sex=2&index=3&genre=2

示例截图:

获取歌手被关注数量信息

接口说明: 调用此接口, 可获取歌手被关注数量信息

参数列表:

必选参数
- singermid: 歌手id

接口地址: /getSingerStarNum

调用例子: /getSingerStarNum?singermid=0025NhlN2yWrP4

示例截图:

获取电台列表

接口说明: 调用此接口, 可获取电台列表, 分类

接口地址: /getRadioLists

调用例子: /getRadioLists

示例截图:

获取专辑

接口说明: 调用此接口, 可获取专辑信息(专辑列表、详情)

参数列表:

必选参数
- albummid: 专辑id

接口地址: /getAlbumInfo

调用例子: /getAlbumInfo?albummid=0016l2F430zMux

示例截图:

获取数字专辑

接口说明: 调用此接口, 可获取数字专辑, 轮播图banner, 专辑列表等信息, 详见API结构图

接口地址: /getDigitalAlbumLists

调用例子: /getDigitalAlbumLists

示例截图:

获取歌曲歌词

接口说明: 调用此接口, 可获取歌曲歌词

参数列表:

必选参数
- songmid: 专辑id
可选参数
- isFormat: 是否格式化歌词, 默认值为 false

接口地址: /getLyric

调用例子: /getLyric?songmid=003rJSwm3TechU

示例截图:

获取MV

接口说明: 调用此接口, 可获取MV以及其Tag信息

参数列表:

必选参数
- area_id: 区域id, 默认值为全部(15)

Area

"area": [
  {
    "id": 15,
    "name": "全部"
  },
  {
    "id": 16,
    "name": "内地"
  },
  {
    "id": 17,
    "name": "港台"
  },
  {
    "id": 18,
    "name": "欧美"
  },
  {
    "id": 19,
    "name": "韩国"
  },
  {
    "id": 20,
    "name": "日本"
  }
]

version_id: 版本id, 默认值为全部(7)

Version

"version": [
  {
    "id": 7,
    "name": "全部"
  },
  {
    "id": 8,
    "name": "MV"
  },
  {
    "id": 9,
    "name": "现场"
  },
  {
    "id": 10,
    "name": "翻唱"
  },
  {
    "id": 11,
    "name": "舞蹈"
  },
  {
    "id": 12,
    "name": "影视"
  },
  {
    "id": 13,
    "name": "综艺"
  },
  {
    "id": 14,
    "name": "儿歌"
  }
]

可选参数
- page: 当前页数, 默认为1
- limit: 取出歌单数量, 默认为 20

接口地址: /getMv

调用例子: /getMv

示例截图:

获取新碟信息

接口说明: 调用此接口, 可获取新碟信息

参数列表:

可选参数
- page: 当前页数, 默认为 1
- limit: 取出歌单数量, 默认为 20

接口地址: /getNewDisks

调用例子: /getNewDisks

示例截图:

获取歌手专辑

接口说明: 调用此接口, 可获取歌手专辑

参数列表:

必选参数
- singermid: 歌手id
可选参数
- page: 当前页数, 默认为1
- limit: 取出歌单数量, 默认为 20

接口地址: /getSingerAlbum

调用例子: /getSingerAlbum?singermid=0025NhlN2yWrP4

示例截图:

获取歌曲相关信息

接口说明: 调用此接口, 可获取歌曲相关信息

参数列表:

必选参数
- songmid: 歌曲id

接口地址: /getSongInfo

调用例子: /getSongInfo?songmid=0025NhlN2yWrP4

示例截图:

批量获取歌曲相关信息

接口说明: 调用此接口, 可批量获取歌曲相关信息

参数列表:

必选参数

songs: [
  [songmid, songid]
]

其中 songid可以不传

接口地址: /batchGetSongInfo

调用例子: /batchGetSongInfo

{
  "songs": [
    ["001CLC7W2Gpz4J"],
    ["0025NhlN2yWrP4"]
  ]
}

示例截图:

获取歌曲播放链接

接口说明: 调用此接口, 可获取歌曲播放链接

参数列表:

必选参数
songmid: 歌曲id, 多个播放链接使用 ,分隔
justPlayUrl: 仅返回播放链接, 默认是 play。[all | play]
quality: 播放品质, 默认是 128。[m4a | 128 | 320 | ape | flac]

接口地址: /getMusicPlay

调用例子:

示例截图:

获取单个播放链接

例子: /getMusicPlay?songmid=0012g3Et1iFQCC

获取多个播放链接

例子: /getMusicPlay?songmid=001yNIo41SJjuC,001wPuVc4ZiMhj&resType=play

获取多个播放链接

例子: /getMusicPlay?songmid=0012g3Et1iFQCC,001wPuVc4ZiMhj&resType=all

歌曲品质

例子: songmid=001yNIo41SJjuC&resType=play&quality=m4a

获取搜索热词

接口说明: 调用此接口, 可获取搜索热词

接口地址: /getHotkey

调用例子: /getHotkey

示例截图:

获取关键字搜索提示

接口说明: 调用此接口, 可获取获取关键字搜索提示

参数列表:

必选参数
- key: 搜索关键字

接口地址: /getSmartbox

调用例子: /getSmartbox?key=周杰伦

示例截图:

获取搜索结果

接口说明: 调用此接口, 可获取获取搜索结果

参数列表(部分参数待注释):

必选参数
- key: 搜索关键字
- ~~catZhida: 默认值为1~~
  
  ~~1. 0 表示歌曲~~
  
  ~~2. 2 表示歌手~~
  
  ~~3. 3 表示专辑~~
- remoteplace: 默认值为 song
  1. 单曲: song
  2. 专辑: album
  3. MV: mv
  4. 歌单: playlist
  5. 用户: user
  6. 歌词: lyric
可选参数
- page: 当前页数, 默认为 1
- limit: 取出歌单数量, 默认为 10

接口地址: /getSearchByKey

调用例子: /getSearchByKey?key=周杰伦

示例截图:

获取首页推荐

接口说明: 调用此接口, 可获取首页推荐

接口地址: /getRecommend

调用例子: /getRecommend

示例截图:

获取排行榜单列表

接口说明: 调用此接口, 可获取排行榜单列表

可选参数
- page: 当前页数, 默认为 1
- limit: 取出歌单数量, 默认为 10

接口地址: /getTopLists

调用例子: /getTopLists

示例截图:

获取排行榜单详情

接口说明: 调用此接口, 可获取排行榜单详情

可选参数
- topId: 榜单id
- page: 当前页数, 默认为1
- limit: 取出歌单数量, 默认为 10

接口地址: /getRanks

调用例子: /getRanks

示例截图:

获取评论信息(cmd代表的意思没太弄明白)

接口说明: 调用此接口, 可获取评论信息

必选参数
- id: 专辑或者歌单请求结果的id
可选参数
- rootcommentid: 榜单id
- cid:
- pagenum: 当前页数, 默认为 0
- pagesize: 取出评论数量, 默认为 25
- cmd:
- reqtype:
- biztype:

接口地址: /getComments

调用例子: /getComments?id=8220&rootcommentid=album_8220_1003310416_1558068713

示例截图:

获取歌曲 + 专辑图片

接口说明: 调用此接口, 可获取票务信息

必选参数
- id: 专辑或者歌单请求结果的id
可选参数
- size: 图片大小, 默认 300x300
- maxAge: 图片过期时间, 默认 12 mins = 2592000ms

接口地址: /getImageUrl

调用例子: /getImageUrl?id=000MkMni19ClKG or /getImageUrl?id=000MkMni19ClKG&size=500x500

示例截图:

获取票务信息

接口说明: 调用此接口, 可获取票务信息

接口地址: /getTicketInfo

调用例子: /getTicketInfo

示例截图:

Files

docs

Directory actions

More options

Directory actions

More options

Latest commit

History

docs

Folders and files

parent directory

README.md

QQ Music API

API结构图

API接口

新特性

支持自定义设置cookie

格式化自定义的 cookie

特性提示支持

获取 Cookie

获取QQ音乐产品的下载地址

获取歌单分类

获取歌单列表

批量获取歌单列表

获取歌单详情

获取MV标签

获取MV播放信息

获取歌手MV

获取歌手热门歌曲

获取相似歌手

获取歌手信息

获取歌手列表

获取歌手被关注数量信息

获取电台列表

获取专辑

获取数字专辑

获取歌曲歌词

获取MV

获取新碟信息

获取歌手专辑

获取歌曲相关信息

批量获取歌曲相关信息

获取歌曲播放链接

获取单个播放链接

获取多个播放链接

获取多个播放链接

歌曲品质

获取搜索热词

获取关键字搜索提示

获取搜索结果

获取首页推荐

获取排行榜单列表

获取排行榜单详情

获取评论信息(cmd代表的意思没太弄明白)

获取歌曲 + 专辑 图片

获取票务信息

获取歌曲 + 专辑图片