参数名	类型	必填	说明	示例
action	string	是	操作类型，可为：search, play（分别对应：搜索、播放url获取）	search
msg	string	否	搜索关键词，当action为search时有效。	稻香
rid	string	否	歌曲id，搜索列表里rid的值，当action为playh时有效。	287151088
br	string	否	歌曲音质，搜索列表里qualities内的level的值，当action为playh时有效。	p

酷我音乐

接口说明

酷我音乐接口提供音乐搜索及播放URL获取功能，支持按关键词搜索歌曲并获取多种音质的播放地址，适用于需要集成在线音乐播放能力的服务。接口调用无需认证，完全免费开放使用。

调用地址

/v1/music_kw.php

请求方式

GET，POST

鉴权说明

无需密钥。

请求参数

参数名	类型	必填	说明
action	string	是	操作类型，取值 `search`（搜索）或 `play`（获取播放链接）
msg	string	否	搜索关键词，仅在 `action` 为 `search` 时有效
rid	string	否	歌曲ID，搜索结果列表中的 `rid` 字段值，用于 `action` 为 `play` 时指定目标歌曲
br	string	否	歌曲音质级别，搜索结果列表中 `qualities` 数组内对应项的 `level` 值，用于 `action` 为 `play` 时指定音质

成功响应示例

{
  "code": 200,
  "msg": "搜索成功",
  "data": {
    "list": [
      {
        "rid": "287151088",
        "name": "稻香(DJ版)",
        "artist": "唐小力",
        "artist_id": "1369928",
        "album": "中文DJ",
        "album_id": "16154807",
        "duration": 371,
        "pic": "https://img4.kuwo.cn/star/albumcover/120/s4s92/84/4078246155.jpg",
        "artist_pic": "https://img1.kuwo.cn/star/starheads/120/s4s0/2/3728796146.jpg",
        "mv_pic": "",
        "has_mv": false,
        "mv_id": "",
        "pay_info": {
          "play": 1000,
          "download": 1000,
          "paytype": 0,
          "fee_type": {
            "album": "0",
            "bookvip": "0",
            "song": "0",
            "vip": "1"
          }
        },
        "qualities": [
          {
            "level": "p",
            "bitrate": 320,
            "format": "mp3",
            "size": "14.18Mb",
            "name": "高品质",
            "br_param": "320kmp3",
            "available": true
          },
          {
            "level": "h",
            "bitrate": 128,
            "format": "mp3",
            "size": "5.67Mb",
            "name": "标准",
            "br_param": "128kmp3",
            "available": true
          },
          {
            "level": "s",
            "bitrate": 48,
            "format": "aac",
            "size": "2.16Mb",
            "name": "流畅",
            "br_param": "128kmp3",
            "available": true
          }
        ],
        "release_date": "",
        "subtitle": "",
        "alias": "",
        "online": true,
        "cache_status": true,
        "kmark": 0,
        "is_pay": true,
        "song_name": "稻香(DJ版) (改编版原唱: 周杰伦)"
      }
    ],
    "total": 3594,
    "page": 1,
    "size": 20,
    "_debug": {
      "from_cache": false
    }
  },
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

字段名	类型	说明
code	integer	状态码，200表示成功
msg	string	操作结果的文字描述
data	object	返回的数据主体
tips	string	提示信息

data 对象

字段名	类型	说明
list	array	歌曲列表数组
total	integer	搜索结果总数
page	integer	当前页码
size	integer	每页返回的条目数
_debug	object	调试信息

list 数组元素（歌曲对象）

字段名	类型	说明
rid	string	歌曲唯一标识ID
name

错误响应示例

当请求发生错误时，接口将返回以下 JSON 结构：

{
    "code": 0,
    "msg": "请求过于频繁，请稍后再试",
    "errcode": 11005
}

业务错误码说明

错误码	说明
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://api.xiaoapi.cn/v1/music_kw.php" \
  -d "action=search" \
  -d "msg=稻香"

获取歌曲播放地址（rid=287151088，音质=高品质320kmp3）：

curl -X POST "https://api.xiaoapi.cn/v1/music_kw.php" \
  -d "action=play" \
  -d "rid=287151088" \
  -d "br=p"

PHP

搜索歌曲「稻香」：

// PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.xiaoapi.cn/v1/music_kw.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    "action" => "search",
    "msg" => "稻香"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

获取歌曲播放地址（rid=287151088，音质=高品质320kmp3）：

// PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.xiaoapi.cn/v1/music_kw.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    "action" => "play",
    "rid" => "287151088",
    "br" => "p"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

请求方式：支持 GET 与 POST 两种方式，复杂查询建议使用 POST。
action 参数必填：必须指定 search 或 play，未提供或值非法将无法获取有效响应。
参数对应关系：msg 仅在 action=search 时生效，rid 与 br 仅在 action=play 时生效，混用不会报错但可能返回空数据。
音质参数 br：取值为 qualities 数组中各对象的 level 字段值，如 p（高品质 320k mp3）、h（标准 128k mp3）、s（流畅 48k aac）、ff（无损 flac），部分歌曲支持的无损格式需留意 available 字段。
搜索结果分页：返回数据包含 total（总条数）、page、size，可据此自行实现翻页逻辑。
图片与链接：返回的 pic、artist_pic、mv_pic 等图片地址来源于外部资源，直接使用可能存在时效性问题，建议自行缓存或做兜底处理。
资源版权：部分歌曲受版权保护，pay_info 中的字段反映该资源的商业状态，请确保用途合规。

酷我音乐

请求参数

返回示例

详细文档

酷我音乐

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

data 对象

list 数组元素（歌曲对象）

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

AI聊天