酷狗MV

接口说明

酷狗MV用于按关键词检索并获取对应的MV视频资源，适合需要在应用或页面中嵌入音乐视频播放能力的开发者。

接口返回视频的基础信息与多品质播放地址，画质支持 480p 与 1080p，调用无需密钥、不产生费用。

调用地址

https://xiaoapi.cn/v1/mv_kg.php

请求方式

支持 GET 与 POST 两种请求方式，参数可置于查询字符串或表单正文中提交。

鉴权说明

本接口无需密钥，可直接调用，不限制调用身份。

请求参数

参数取值说明：

• n 从 1 开始计数，对应 msg 检索结果列表中的条目顺序；取值应为正整数，且不超过该关键词返回的列表总条数。
• msg 需进行 URL 编码后再传递，关键词中不建议包含特殊字符或多余空格。
• n 仅用于在关键词列表中选择具体条目，不参与关键词匹配；同一 msg 在不同时间检索出的列表顺序可能变化，若需稳定的资源地址，请先获取列表再按需请求详情。

成功响应示例

{
  "code": 200,
  "name": "稻香",
  "singer": "周杰伦",
  "cover": "https://imgessl.kugou.com/mvhdpic/240/20240102/20240102154336426797.jpg",
  "mv_hot": 17637,
  "resolution": "1080P",
  "collect_count": 272317,
  "comment_count": 14876,
  "like_count": 321914,
  "play_count": 49243460,
  "up_time": "2008-10-15",
  "urls": [
    {
      "filesize": 59933303,
      "time": "3:44",
      "url": "http://fsmvpc.kugou.com/202510192044/9bd85e6f8b422a876628c6203771b26d/KGTX/CLTX002/c88babff62c04e6bd55bc8238a5bc328.mp4"
    },
    {
      "filesize": 15021936,
      "time": "3:44",
      "url": "http://fsmvpc.kugou.com/202510192044/57bbb9938cd39cc532e9965a029fc465/KGTX/CLTX002/00966e219c5beaae078d1ae804c70fbf.mp4"
    },
    {
      "filesize": 116056070,
      "time": "3:44",
      "url": "http://fsmvpc.kugou.com/202510192044/6017c4ac1829549bae4cc5fc17bb4f2b/KGTX/CLTX002/503de3153bff970f348e27e355139d24.mp4"
    }
  ],
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

错误响应示例

调用失败时，接口统一返回 JSON 结构，其中 code 固定为 0，msg 为错误描述，errcode 为业务错误码。可依据 errcode 做精确的失败处理。

未提供调用密钥：

{"code":0,"msg":"未提供调用密钥","errcode":11001}

密钥错误：

{"code":0,"msg":"密钥错误","errcode":11002}

积分余额不足：

{"code":0,"msg":"积分余额不足","errcode":11004}

请求过于频繁：

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

接口不存在：

{"code":0,"msg":"接口不存在","errcode":11013}

服务暂不可用：

{"code":0,"msg":"服务暂不可用，请稍后再试","errcode":11017}

业务错误码说明

上述错误码均以 code 为 0、errcode 为载体返回。其中 11013 至 11016 及 11017 同样适用于本类视频检索调用，出现时按上表建议逐项排查即可。

调用示例

终端 curl（bash）

关键词检索，返回匹配的 MV 列表：

curl -G "https://xiaoapi.cn/v1/mv_kg.php" \
  --data-urlencode "msg=稻香"

按列表序号获取具体 MV 资源：

curl -G "https://xiaoapi.cn/v1/mv_kg.php" \
  --data-urlencode "msg=稻香" \
  --data-urlencode "n=1"

PHP

// PHP 示例
$params = [
    'msg' => '稻香',
    'n'   => 1,
];

$url = 'https://xiaoapi.cn/v1/mv_kg.php?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

注意事项

• 关键词编码：msg 通常为中文（如「稻香」），使用 GET 调用时需先做 URL 编码，避免因特殊字符或空格导致请求失败；POST 提交时字段名保持 msg 不变。
• n 的用法：不传 n 时返回的是该关键词匹配到的 MV 列表，用于查看有哪些结果；