Q~音乐,拥有曲库最全、版权最多的音乐平台。(数据外接版,可获取会员资源)
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| msg | string | 是 | 需要搜索的音乐名称,例如:稻香 | 稻香 |
| n | integer | 否 | 需要返回播放链接的序号,为空则返回歌曲关键词列表,有则返回当前序号歌曲播放内容 | 1 |
[
{
"name": "msg",
"type": "string",
"required": true,
"description": "需要搜索的音乐名称,例如:稻香",
"example": "稻香"
},
{
"name": "n",
"type": "integer",
"required": false,
"description": "需要返回播放链接的序号,为空则返回歌曲关键词列表,有则返回当前序号歌曲播放内容",
"example": "1"
}
]
{"openapi":"3.1.1","info":{"title":"QQ音乐","description":"Q~音乐,拥有曲库最全、版权最多的音乐平台。(数据外接版,可获取会员资源)","version":"1.0.0"},"paths":{"/v1/yy_sq.php":{"get":{"summary":"QQ音乐","description":"Q~音乐,拥有曲库最全、版权最多的音乐平台。(数据外接版,可获取会员资源)","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"稻香"},"description":"需要搜索的音乐名称,例如:稻香"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"需要返回播放链接的序号,为空则返回歌曲关键词列表,有则返回当前序号歌曲播放内容"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"QQ音乐","description":"Q~音乐,拥有曲库最全、版权最多的音乐平台。(数据外接版,可获取会员资源)","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"稻香"},"description":"需要搜索的音乐名称,例如:稻香"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","example":1},"description":"需要返回播放链接的序号,为空则返回歌曲关键词列表,有则返回当前序号歌曲播放内容"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_3.jpg",
"name": "稻香",
"singer": "周杰伦",
"quality": "SQ无损",
"url": "http://aqqmusic.tc.qq.com/amobile.music.tc.qq.com/F0000020wJDo3cx0j3.flac?guid=0&vkey=4F10885EC144274855EBDE13A540EB7BAE9DA8B756314DB5B23C76E0C5A843501E0D29DAB58B0095291E9FD9CA95F90FA27B905FD9BADAFA__v2b94c5c1&uin=1828222534&fromtag=119117",
"tips": "慕名API:http://xiaoapi.cn"
}
该接口提供QQ音乐曲库搜索功能,支持通过音乐名称快速检索歌曲信息并获取对应的播放资源链接,适用于需要在应用中集成音乐播放能力的开发者或用户。
/v1/yy_sq.php
GET、POST
无需密钥即可调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| msg | string | 是 | 需要搜索的音乐名称,例如:稻香 |
| n | integer | 否 | 需要返回播放链接的序号,为空则返回歌曲关键词列表,有则返回当前序号歌曲播放内容 |
参数取值说明
| 参数 | 取值 | 含义 |
|---|---|---|
| msg | 任意字符串 | 音乐名称关键词 |
| n | 正整数 | 歌曲列表序号,返回对应歌曲的播放链接 |
{
"code": 200,
"cover": "https://y.qq.com/music/photo_new/T002R300x300M000002Neh8l0uciQZ_3.jpg",
"name": "稻香",
"singer": "周杰伦",
"quality": "SQ无损",
"url": "http://aqqmusic.tc.qq.com/amobile.music.tc.qq.com/F0000020wJDo3cx0j3.flac?guid=0&vkey=4F10885EC144274855EBDE13A540EB7BAE9DA8B756314DB5B23C76E0C5A843501E0D29DAB58B0095291E9FD9CA95F90FA27B905FD9BADAFA__v2b94c5c1&uin=1828222534&fromtag=119117",
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 响应状态码,200 表示成功 |
| cover | string | 歌曲封面图片地址 |
| name | string | 歌曲名称 |
| singer | string | 歌手名称 |
| quality | string | 音乐品质,如 SQ 无损 |
| url | string | 歌曲播放链接 |
| tips | string | 提示信息 |
GET /v1/yy_sq.php?msg=%E7%A8%8B%E9%A6%99&n=1
{"code":0,"msg":"密钥错误","errcode":11002}
{"code":0,"msg":"请求过于频繁,请稍后重试","errcode":11005}
{"code":0,"msg":"接口维护中","errcode":11006}
{"code":0,"msg":"接口不存在","errcode":11013}
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
# 搜索音乐
curl -X POST "https://xiaoapi.cn/v1/yy_sq.php" \
-d "msg=稻香"
# 获取指定序号歌曲的播放链接
curl -X POST "https://xiaoapi.cn/v1/yy_sq.php" \
-d "msg=稻香&n=1"
// 搜索音乐并获取播放链接
$url = "https://xiaoapi.cn/v1/yy_sq.php";
$data = ["msg" => "稻香", "n" => 1];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
echo $result["url"];
url 播放地址具有时效限制,请获取后尽快使用,避免过期导致播放失败。msg 需进行 URL 编码处理,建议对特殊字符(如 &、#、% 等)进行转义,防止解析异常或安全问题。code 字段判断请求状态,当 code 不为 200 时表示查询失败,程序应做好异常捕获与容错处理。curl "http://xiaoapi.cn/v1/yy_sq.php?msg=稻香"
// 结果将在此处显示