加载中...

QQ音乐 API 文档

提供丰富的QQ音乐相关API，包括音乐搜索、歌单获取、歌词查询、用户信息等功能。

浏览 API 查看示例

概览

QQ音乐 API 提供了一系列与QQ音乐相关的接口，支持音乐搜索、歌单管理、歌词查询、用户信息获取等功能。 所有API都需要携带有效的cookies信息才能正常调用。

音乐搜索

根据关键词搜索歌曲、歌手、专辑等信息。

歌单管理

获取推荐歌单、分类歌单、歌单详情等。

用户信息

获取用户个人信息、金币、签到状态等。

认证

所有API请求都需要携带有效的QQ音乐cookies信息，支持以下几种方式：

方式一：通过请求头携带

GET /api/search?query=周杰伦 HTTP/1.1
Host: 127.0.0.1:3000
Uin: 123456789
Qm-keyst: your_music_key

方式二：通过Cookies携带

GET /api/search?query=周杰伦 HTTP/1.1
Host: 127.0.0.1:3000
Cookie: uin=123456789; qm_keyst=your_music_key; qqmusic_key=your_music_key

方式三：通过请求体携带（仅POST请求）

POST /api/sign HTTP/1.1
Host: 127.0.0.1:3000
Content-Type: application/json

{
  "musicid": "123456789",
  "musickey": "your_music_key",
  "type": "continue"
}

API 端点

API 目录

扫码登录获取 CK

点击展开

通过扫码登录获取 QQ 音乐的 cookies 信息

GET

请求端点

/api/login/qrcode

参数

无

检查登录状态

点击展开

检查扫码登录状态，获取登录后的 cookies 信息

调用次数: 0 GET

请求端点

/api/login/check?key=登录会话密钥

参数

参数名 类型 必填 描述
key string 是 登录会话密钥，通过 /api/login/qrcode 获取

搜索音乐

点击展开

根据关键词搜索音乐

调用次数: 0 GET

请求端点

/api/search?query=关键词&page=1&page_size=15

参数

参数名 类型 必填 描述
query string 是 搜索关键词
page number 否 页码，默认 1
page_size number 否 每页结果数量，默认 15

获取歌单详情

点击展开

根据歌单ID获取歌单详细信息

调用次数: 0 GET

请求端点

/api/playlist?id=歌单ID&num=30

参数

参数名 类型 必填 描述
id string 是 歌单ID
num number 否 获取歌曲数量，默认 30

获取用户信息

点击展开

获取当前用户的详细信息

调用次数: 0 GET

请求端点

/api/user

参数

无

签到

点击展开

每日签到领取金币

POST

请求端点

/api/sign

请求体

{
  "type": "continue" // 签到类型，默认 continue
}

添加评论

点击展开

为歌曲、专辑或歌单添加评论

调用次数: 0 POST

请求端点

/api/addcomment

请求体

{
  "content": "评论内容", // 评论内容
  "bizid": "业务ID", // 歌曲ID、专辑ID或歌单ID
  "biztype": 1, // 业务类型：1=歌曲，2=专辑，3=歌单
  "repliedcmid": null // 回复的评论ID，默认 null
}

创建音乐金币任务

点击展开

提交音乐金币任务，系统会自动执行领取金币操作

调用次数: 0 POST

请求端点

/api/coin/task

参数

通过请求头或Cookies携带 musicid 和 musickey

检查音乐金币任务状态

点击展开

检查提交的音乐金币任务执行状态

调用次数: 0 GET

请求端点

/api/coin/task/check?taskId=任务ID

参数

参数名 类型 必填 描述
taskId string 是 任务ID，通过 /api/coin/task 获取

授权扫码登录QQ音乐

点击展开

通过传入二维码图片的base64数据进行登录

调用次数: 0 POST

请求端点

/api/login/qrcode

请求体

{
  "base64": "二维码图片的base64数据" // 二维码图片的base64编码，支持带data:image前缀
}

获取音乐播放地址

点击展开

获取指定音质的音乐播放地址

调用次数: 0 GET

请求端点

/api/musicurl?songmid=歌曲MID&fileType=音质类型

参数

参数名 类型 必填 描述
songmid string 是 歌曲MID标识
fileType string 否 音质类型，默认'128'，支持的值：'128'（128kbps）、'320'（320kbps）、'flac'（无损音质）

获取歌词

点击展开

获取歌曲的歌词信息，支持原歌词和翻译歌词

调用次数: 0 GET

请求端点

/api/lyric?mid=歌曲MID或歌曲ID

参数

参数名 类型 必填 描述
mid string 是 歌曲MID或歌曲ID（自动判断）

id和mid互相转换

点击展开

自动判断输入是歌曲ID还是MID，返回对应的id和mid

调用次数: 0 GET

请求端点

/api/convert?id=歌曲ID或MID

参数

参数名 类型 必填 描述
id string 是 歌曲ID或歌曲MID

获取听歌报告

点击展开

获取用户的听歌报告截图，包括总计、今日、本周和本月报告

调用次数: 0 GET

请求端点

/api/listenreport

参数

无

加速歌曲播放

点击展开

加速指定歌曲的播放，增加听歌时长

调用次数: 0 POST

请求端点

/api/accelerate/song

请求体

{
  "songInfo": {
    "songName": "歌曲名",
    "singer": "歌手名",
    "singerId": "歌手ID",
    "songId": "歌曲ID"
  }
}

获取歌单用于刷歌

点击展开

获取用户歌单列表，用于刷歌操作

调用次数: 0 GET

请求端点

/api/accelerate/songlist?dirid=202&num=300

参数

参数名 类型 必填 描述
dirid number 否 歌单目录ID，201=我喜欢，202=今日推荐，默认202
num number 否 获取歌曲数量，默认300

刷新音乐密钥

点击展开

刷新用户的音乐密钥，使用QQMusicApi中的refresh()方法，确保API调用正常

调用次数: 0 POST

请求端点

/api/accelerate/refreshkey

参数

通过请求头或Cookies携带 musicid 和 musickey

实现说明

使用QQMusicApi中的refresh()方法，该方法会重新登录并获取新的音乐密钥，确保API调用的正常进行。

获取用户详细信息

点击展开

获取用户的详细信息，包括昵称、头像、音响力等级等

调用次数: 0 GET

请求端点

/api/accelerate/userinfo

参数

通过请求头或Cookies携带 musicid 和 musickey

获取API统计信息

点击展开

获取所有API的调用次数统计

调用次数: 0 GET

请求端点

/api/stats

参数

无