QQmv

接口说明

按歌曲名称查询相关 MV 视频，返回封面、歌手与可播放的视频地址，覆盖 480p、1080p 等分辨率。适合需要在音乐播放、MV 点播或内容聚合场景中按歌名补充视频资源的开发者使用。接口免费，调用地址为 https://xiaoapi.cn/v1/mv.php，支持 GET 与 POST，无需密钥。

调用地址

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

请求方式

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

鉴权说明

本接口无需密钥，直接请求调用地址并携带所需参数即可使用，不产生费用。

请求参数

调用地址：https://xiaoapi.cn/v1/mv.php

请求方式：GET 或 POST。无需密钥，免费调用。

参数取值说明：

• msg 建议使用歌曲名称本身，避免附加歌手、专辑等多余文字，以提高匹配准确度。
• n 从 1 开始计数，取值为正整数；不传该参数时按列表形式返回。

成功响应示例

请求成功时，接口返回 JSON 对象，code 为 200，并携带封面、歌曲、歌手以及可播放的视频地址列表。

{
  "code": 200,
  "cover": "http://y.gtimg.cn/music/photo_new/T015R640x360M101003C7TmG43jmgE.jpg",
  "name": "稻香",
  "singer": "周杰伦",
  "url": [
    "https://mv6.music.tc.qq.com/40B6325D64855C859D61EDC3F7A1E42262841CB6E1D7FF3465823BB62115B558F348058516068581499895966ACA9A77ZZqqmusic_default__v2b95efe2/qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9814.mp4?fname=qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9814.mp4",
    "https://mv6.music.tc.qq.com/34B776F5EBD626EE77CC306EB641278B66FB540F15CFE0429C16D1092D7347D499E10040EE96F6AAA9ECA3CB1F2AC75DZZqqmusic_default__v2b95efe2/qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9824.mp4?fname=qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9824.mp4",
    "https://mv6.music.tc.qq.com/45995EA6DC1D52BDCD56F2747109A7A3102D08A4CEE485AA8B8EDA9D531514278B447CB676135AB6C7FD475961CBEB88ZZqqmusic_default__v2b95efe2/qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9834.mp4?fname=qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9834.mp4",
    "https://mv6.music.tc.qq.com/BE51E6274DC6B7DADB632BC31CC248BB3AA29860BF319AF695ED4CB2E808FE70D0EDC54E2022095D18FD816172E4FAA0ZZqqmusic_default__v2b95efe2/qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9844.mp4?fname=qmmv_0b6bsqaawaaasmahuubamfrfjfaabokaac2a.f9844.mp4"
  ],
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

说明：

• 未传入 n 时，url 返回该歌曲的相关 MV 视频地址列表；传入 n 时，返回当前 MV 列表第 n 条对应的视频信息。
• url 中各元素均为完整可访问的视频文件地址，清晰度由列表顺序区分，通常由低到高排列。

错误响应示例

接口在参数缺失、密钥无效、额度不足、频率超限或服务不可用等情况下，返回 HTTP 状态码为 200 的 JSON 体，业务结果由 code 与 errcode 表达：code 为 0 表示本次调用未成功，errcode 为具体业务错误码，msg 为可读提示。

未提供调用密钥：

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

密钥错误：

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

积分余额不足：

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

请求过于频繁：

{"code":0,"msg":"请求过于频繁（QPM 限制）","errcode":11005}

接口不存在：

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

业务错误码说明

需要对 11013～11016 与 11017 作补充说明：凡走出口代理能力的接口，在路径匹配、目标地址校验与目标取数三个阶段会分别返回 11013、11014/11015、11016；当整体链路或节点不可用时统一返回 11017。此类接口同样适用上表中的 11001～11012 与 11018～11024 各错误码。

调用示例

以下示例使用本站调用地址 https://xiaoapi.cn/v1/mv.php，请求方式为 GET 或 POST，无需密钥。参数 msg 为歌曲名称（必填），n 为 MV 列表中的第几条（可选，留空则返回相关 MV 列表）。

终端 curl（bash）

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

PHP

// PHP
$query = http_build_query([
    'msg' => '稻香',
    'n'   => 1,
]);

$url = 'https://xiaoapi.cn/v1/mv.php?' . $query;

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

$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

• 本接口无需密钥，调用时不必携带任何鉴权参数；请勿把本站调用地址转发给不可信的第三方，避免被恶意刷量。
• 请求地址统一使用 https://xiaoapi.cn/v1/mv.php，请勿改为 HTTP 明文访问，以免请求参数与返回的视频链接在传输途中被篡改或窃听。
• msg 为必填项，取值应为歌曲名称文本，建议使用简体中文歌名并去掉多余的符号、空格与后缀说明（如「- Live」「(MV版)」），以提高匹配命中率；歌名过短或过于生僻时可能匹配不到结果。
• n 为可选项，省略时返回该歌名相关的 MV 列表；传入时用于取列表中指定序号的那一条，取值应为从 1 开始的正整数，超出实际条数会取不到对应数据。若只需一条结果，建议先不带 n 调用一次，确认列表长度后再取具体序号。
• 返回值中的 url 是包含多种分辨率的视频直链数组（如 480p、1080p 等），不同清晰度对应不同元素，请按实际播放需求选取；这些链接具有时效性，请勿长期缓存或写入数据库后反复分发，建议在每次播放前实时获取。
• cover、url 等字段来自歌曲名匹配结果，可能出现同名不同歌手、翻唱或现场版的情况，业务上如需精确结果，请结合 name、singer 字段自行校验后再使用。
• 本接口免费，但请合理控制调用频率，避免短时间内对同一歌名高频重复请求；批量任务请加入适当间隔，防止被限流而影响其它正常调用。
• 若将本接口用于网页或小程序端，请通过自己的服务端转发调用，不要把本站地址与请求过程直接暴露在前端代码中，也不要将返回的视频链接用于超出授权范围的二次分发。
• 返回结果中的 code 为 200 表示成功；未匹配到 MV、歌名为空或参数格式不正确时会返回相应错误信息，请在代码中先判断状态再做后续解析，避免对非成功响应直接取 url 字段导致异常。