慕名API

/ 接口详情

/ 接口详情 · 音乐

GET / POST

QQ音乐

Q~音乐,拥有曲库最全、版权最多的音乐平台。（数据外接版，可获取会员资源）

调用 310,568 次免费 KEY 必填 QPM 35/MIN Query 参数、Header(X-API-Key)、Bearer Token

返回接口市场

接口信息

GET / POST xiaoapi.cn/v1/yy_sq.php

方法

GET / POST

分类

音乐

计费

免费

KEY

KEY 必填

调用

310,568

QPM

35/MIN

鉴权

Query 参数、Header(X-API-Key)、Bearer Token

作者

Admin

请求参数

参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
msg	string	是	需要搜索的音乐名称，例如：稻香	稻香
n	integer	否	需要返回播放链接的序号，为空则返回歌曲关键词列表，有则返回当前序号歌曲播放内容	1

[
    {
        "name": "key",
        "type": "string",
        "required": true,
        "description": "接口调用密钥",
        "example": ""
    },
    {
        "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": "key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "接口调用密钥"
                    },
                    {
                        "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": "key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "接口调用密钥"
                    },
                    {
                        "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": "https://xiaoapi.cn",
            "description": "当前访问入口（https）"
        }
    ]
}

返回示例

{
  "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音乐

接口说明

该接口提供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）

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（bash）

# 搜索音乐
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"

PHP

// 搜索音乐并获取播放链接
$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 编码处理，建议对特殊字符（如 &、#、% 等）进行转义，防止解析异常或安全问题。
HTTPS 访问：建议优先使用 HTTPS 协议调用接口，确保传输链路安全。
返回值校验：根据 code 字段判断请求状态，当 code 不为 200 时表示查询失败，程序应做好异常捕获与容错处理。
资源使用规范：该接口为免费接口，请合理控制请求频率，避免对服务稳定性造成影响。

快速上手

curl "http://xiaoapi.cn/v1/yy_sq.php?msg=稻香"

在线测试

请求地址

xiaoapi.cn/v1/yy_sq.php

Method

参数

key * msg * n

Response

等待中

// 结果将在此处显示

推荐接口

音乐 GET

酷狗铃声

获取铃声、视频铃声资源

18 次调用 1.1积分/次 KEY必填

服务免责声明

生效日期：2026年7月22日

欢迎使用 xiaoapi.cn（以下简称"本平台"）。在使用本平台提供的 API 服务（以下简称"本服务"）前，请务必仔细阅读并充分理解本免责声明。您以任何方式调用、访问或使用本服务，即视为您已阅读、理解并同意接受本声明的全部内容。

一、声明目的

本平台作为 API 技术服务的提供方，仅提供技术接口与数据分发服务。本声明的目的在于明确平台与用户之间的责任边界，督促用户合法、合规地使用本服务，防范违法违规行为的发生。

二、用户责任与合规承诺

用户应为自身的一切调用行为承担全部责任，包括但不限于调用方式、调用目的、数据使用、结果传播及由此产生的全部后果。
用户承诺在使用本服务过程中，严格遵守中华人民共和国法律法规以及所在国家/地区的适用法律，包括但不限于《网络安全法》《数据安全法》《个人信息保护法》《著作权法》《刑法》及相关司法解释。
用户承诺不以任何方式利用本服务从事损害国家利益、社会公共利益、他人合法权益的活动。

三、禁止性行为

用户在使用本服务时，明确禁止从事以下行为：

利用本服务制作、复制、传播、存储任何法律法规禁止的内容，包括但不限于色情低俗、赌博、诈骗、暴力恐怖、毒品、虚假谣言等信息；
利用本服务从事黑客攻击、入侵、破坏、干扰、非法获取他人数据或系统权限等行为；
利用本服务侵犯他人知识产权、商业秘密、个人隐私或其他合法权益；
利用本服务实施网络诈骗、钓鱼、洗钱、电信网络诈骗等违法犯罪活动；
绕过本平台或第三方平台的安全机制、访问控制、收费机制或版权保护措施；
未经授权将本服务用于商业转售、批量恶意调用、恶意抓取、骚扰性推送等行为；
其他违反法律法规或本平台服务协议的行为。

四、第三方内容与数据免责

本服务所分发、转发或返回的部分数据、内容可能来源于第三方接口、公开网络或其他合作方，本平台对其真实性、准确性、合法性不作出任何保证。
因第三方内容、第三方接口异常、第三方版权纠纷或第三方平台政策变化所引发的任何争议、损失，由相关第三方承担责任，本平台不承担由此产生的责任，但将依法配合权利人和主管部门进行处理。

五、平台免责范围

在法律法规允许的最大范围内，本平台对以下情形不承担责任：

用户因违规、违法使用本服务所产生的全部法律责任与后果，均由用户自行承担；
因用户操作不当、接口误用、参数错误、网络环境异常等原因造成的损失；
因不可抗力（包括但不限于自然灾害、政府行为、电力故障、网络中断、第三方服务故障）导致的服务中断、延迟或数据丢失；
因本平台进行必要的系统维护、升级、调整而导致的服务临时不可用；
用户之间、用户与第三方之间因使用本服务产生的纠纷。

六、违规处理与账号管理

本平台有权对用户的调用行为进行监测与审查。
一经发现用户存在违法、违规或违反本声明的行为，本平台有权视情节轻重采取警告、限制调用、暂停服务、封禁账号等措施，并保留向有关主管部门举报、移交司法机关处理的权利。
因用户违规行为导致本平台被第三方索赔、被主管部门处罚或遭受其他损失的，用户应承担全部赔偿责任。

七、赔偿条款

因用户违反本声明或相关法律法规，导致本平台及其关联方、合作方遭受任何损失（包括但不限于赔偿款、罚款、律师费、诉讼费等），用户同意向本平台及相关方承担全部赔偿责任。

八、知识产权

本平台自身的商标、标识、界面设计、技术代码等知识产权归本平台所有，未经许可不得擅自使用。
用户不得利用本服务对第三方知识产权进行侵犯；因用户侵权行为引发的纠纷由用户自行负责。

九、法律适用与争议解决

本声明的订立、解释、变更及争议解决均适用中华人民共和国法律。
因本声明或本服务产生的争议，双方应友好协商解决；协商不成的，任何一方可向本平台运营方所在地有管辖权的人民法院提起诉讼。

十、声明变更

本平台有权根据法律法规变化、业务调整或监管要求，随时修改本声明。修改后的声明将在本页面公布，自公布之日起生效。您继续使用本服务，即视为接受更新后的声明。

十一、联系我们

如您对本声明有任何疑问，或发现他人存在违规使用本服务的行为，欢迎通过本平台公示的联系方式与我们联系，我们将及时处理。

QQ音乐

请求参数

返回示例

详细文档

QQ音乐

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

请求示例（GET）

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

酷狗铃声

服务免责声明

一、声明目的

二、用户责任与合规承诺

三、禁止性行为

四、第三方内容与数据免责

五、平台免责范围

六、违规处理与账号管理

七、赔偿条款

八、知识产权

九、法律适用与争议解决

十、声明变更

十一、联系我们