arrow_back 返回首页

QQ音乐API

搜索和获取QQ音乐歌曲信息,支持音质选择与智能降级

API版本
v2.0.0
状态
check_circle 在线
数据量
20
最后更新
2026-09-19
今日日期
2026-09-19
响应
<100ms

api 接口信息

接口地址
https://ycmusic.us.ci/qqmusic.php
请求方式
GET
返回格式
JSON
编码格式
UTF-8

tune 请求参数

参数 类型 必填 说明
search string 是(mid下可不用) 搜索关键词,如歌曲名、歌手名
n integer 歌曲序号(1-20),不传则返回搜索列表,传入则返回对应序号的歌曲详情
mid string 是(搜索下可不用) mid直接解析音乐
quality string 音质选择:standard(128k) / high(320k) / lossless(无损FLAC) / hires(Hi-Res),默认 lossless

inventory_2 返回说明

字段结构

字段 类型 含义
搜索结果 object 搜索结果对象(搜索模式)
搜索结果.总计 string 搜索结果总数
搜索结果.歌曲列表 array 歌曲列表数组
搜索结果.歌曲列表[].序号 integer 歌曲序号
搜索结果.歌曲列表[].歌曲 string 歌曲名称
搜索结果.歌曲列表[].歌手 string 歌手名称
搜索结果.歌曲列表[].专辑 string 专辑名称
搜索结果.歌曲列表[].时长 string 歌曲时长
搜索结果.歌曲列表[].tips string API标识(星途API)
gqxx object 歌曲信息对象(详情模式)
gqxx.mc string 歌曲名称
gqxx.gs string 歌手名称
gqxx.zj string 专辑名称
gqxx.time string 歌曲时长
gqxx.gqid string 歌曲ID
gqxx.mtid string 歌曲MID
zjfm string 专辑封面URL
lj string 播放链接URL
quality string 实际使用的音质标签(如“无损 FLAC”)
歌词 string 歌词
code integer 错误状态码(如403)
msg string 错误信息

成功示例

// 搜索模式示例:?search=DJ
{
  " 搜索结果": {
    "总计": "20 首歌曲",
    "歌曲列表": [
      {
        "序号": 2,
        "歌曲": "夜色 (DJ Candy)",
        "歌手": "艺涛\/梁剑东",
        "专辑": "夜色",
        "时长": "06:01",
        "tips": "星途API"
      }
    ]
  }
}

// 详情模式示例:?search=DJ&n=2&quality=lossless
{
  "gqxx": {
    "mc": "夜色 (DJ Candy)",
    "gs": "艺涛\/梁剑东",
    "zj": "夜色",
    "time": "06:01",
    "gqid": "123456",
    "mtid": "0023456789abcde"
  },
  "zjfm": "https://y.qq.com/music/photo_new/...",
  "lj": "https://isure.stream.qqmusic.qq.com/...",
  "quality": "无损 FLAC",
  "tips": "星途API"
}
lightbulb 提示
1. 音质参数:standard(128k) / high(320k) / lossless(无损FLAC) / hires(Hi-Res),默认 lossless;2. 指定音质后,若该音质不可用会自动降级,降到底仍无则自动升级;3. 返回的 quality 字段表示实际使用的音质

bar_chart 状态码

200 OK
请求成功,返回正常数据
404 Not Found
暂无数据,分类为空或不存在
500 Error
服务器错误,文件缺失或格式错误

info 使用须知

  • 免费公益接口,请勿用于商业用途
  • 星途制作