QQ音乐API - 接口文档

接口信息

接口地址

https://xingtu.sufox.sbs/api/qqmusic.php

请求方式

GET

返回格式

JSON

编码格式

UTF-8

请求参数

参数	类型	必填	说明
`search`	string	是（mid下可不用）	搜索关键词，如歌曲名、歌手名
`n`	integer	否	歌曲序号（1-20），不传则返回搜索列表，传入则返回对应序号的歌曲详情
`mid`	string	是（搜索下可不用）	mid直接解析音乐

返回说明

字段结构

字段	类型	含义
`搜索结果`	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
`lyric`	string	歌词
`code`	integer	错误状态码（如403）
`msg`	string	错误信息

成功示例

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

// 详情模式示例：?search=DJ&n=2
{
  "gqxx": {
    "mc": "夜色 (DJ Candy)",
    "gs": "艺涛\/梁剑东",
    "zj": "夜色",
    "time": "06:01",
    "gqid": "123456",
    "mtid": "0023456789abcde"
  },
  "zjfm": "https://y.qq.com/music/photo_new/...",
  "lj": "http://ws.stream.qqmusic.qq.com/...",
  "tips": "星途API"
}

提示

使用search参数进行搜索，如需获取某首歌曲的详情，请同时传入n参数指定歌曲序号（1-20）

状态码

200 OK

请求成功，返回正常数据

404 Not Found

暂无数据，分类为空或不存在

500 Error

服务器错误，文件缺失或格式错误

使用须知

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