Skip to content

ZWD11/QQmusicApi

Repository files navigation

QQ音乐API接口服务

Python Version License

项目简介

这是一个基于Python Flask实现的QQ音乐API接口服务,提供了音乐搜索、歌曲信息获取、歌词获取等功能,自带接口测试页面,同时保留了官方返回格式。本项目仅供学习和研究使用。项目不自带cookies,请自备cookies。

免责声明

⚠️ 重要提示:

  1. 本项目仅供个人学习和技术研究使用
  2. 不提供任何VIP/付费音乐资源,可使用自己cookies获取
  3. 禁止用于商业用途
  4. 请遵守相关法律法规,不得用于任何违法用途
  5. 使用本项目请支持正版音乐,购买相关音乐服务

功能特性

  • 🔍 音乐搜索
  • 🎵 获取歌曲播放链接(支持多种音质)
  • 📝 获取歌词
  • 💬 获取歌曲所有类型评论
  • 📊 获取所有歌单信息、用户创建的歌单信息、用户收藏的歌单信息
  • 🖼️ 获取歌曲封面
  • 🎧 获取歌曲音质列表

环境要求

  • Python 3.10+
  • Flask
  • requests
  • execjs
  • 其他依赖见 requirements.txt

快速开始

  1. 克隆项目
git clone https://github.com/ZWD11/QQmusicApi.git
cd QQmusicApi
  1. 安装依赖
pip install -r requirements.txt
  1. 配置Cookie 在 app.py 中配置你的QQ音乐Cookie:
cookie_str = 'your_cookie_here'
  1. 运行服务
python app.py

服务将在 http://localhost:3101 启动,可看到在线测试页面

在线测试页面

alt text

API接口文档

1. 搜索接口

GET /search
参数:
- song_name: 搜索关键词
- page: 页码(可选,默认1)

返回:歌曲列表信息

2. 获取歌曲信息

GET /songinfo
参数:
- songmid: 歌曲ID
- search_term: /search接口里面的搜索关键词

返回:歌曲详细信息(包含歌词、歌名、URL等)

3. 获取音质列表

GET /songurl
参数:
- songmid: 歌曲ID

返回:不同音质的播放地址

4. 获取最高音质

GET /song
参数:
- songmid: 歌曲ID

返回:歌曲最高音质播放地址

5. 获取歌词

GET /lyrics
参数:
- songmid: 歌曲ID

返回:歌词内容

6. 获取评论

GET /comment
参数:
- songid: 歌曲ID
- pagesize: 每页评论数(可选)
- type: 评论类型(1:全部 2:热评 3:精彩评论 4:最新评论)

返回:评论列表

7. 获取歌单

GET /playlist
参数:
- disstid: 分类歌单ID,也就是除了排行榜歌单的其他所有歌单
- topid: 排行榜歌单ID
(二选一)

返回:歌单所有信息,包括歌曲

8. 获取封面

GET /pic
参数:
- albummid: 专辑ID

返回:封面图片URL

9. 获取用户创建的歌单

GET /usonglist
参数:
- id: 用户QQ号

返回:用户创建的歌单信息

10. 获取用户收藏的歌单

GET /ucollectlist
参数:
- id: 用户QQ号

返回:用户收藏的歌单信息

注意事项

  1. Cookie有效期约为2-3天,需要定期更新,不想手动见此(https://github.com/ZWD11/qqmusic-wyy-qrlogin-cookie)
  2. 请控制接口调用频率,避免对服务器造成压力
  3. 建议在本地开发环境或个人服务器上部署使用
  4. 如遇到问题,请检查Cookie是否有效

致谢

感谢以下项目的启发:

许可证

MIT License

About

Python版QQ音乐官转API实现,提供音乐搜索、歌词获取、评论获取、所有歌单获取、音乐图片获取、音乐各音质url获取、用户创建的歌单获取、用户收藏的歌单获取功能,仍可用,链接502是因为防爬已关,跑起来就能用,不可用我会下,格式自调,我直接官转json所以json长

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors