小宇API 用户中心

[工具.酷狗 点歌API]歌曲搜索/选歌/歌单排行/歌单详情

vip的话就看我圈多少了。

接口状态
正常
总调用次数
4
添加时间
2026-11-18
更新时间
2026-11-18

请求地址

https://api.xiaoyu17.cn/API/kg.php

限速设置 (每分钟请求数)

本接口未启用接口限速

请求参数

点击文字展开说明

参数名类型必填说明
apikey string yes API密钥,注册账号免费获取
type string yes 类型,可选:search-搜索歌曲、choose-选择歌曲、song_url-单独获取歌曲链接、rank_list-歌单排行、playlist_detail-歌单详情
word string either 搜索关键词或歌名,仅限type=search或choose必填
choose string either 选择序号,仅限type=choose时必填
page string no 搜索页数,默认1,仅限type=search时选填
pagesize string no 搜索每页返回数量,默认20,仅限type=search时选填
quality string no 音质,如果无法获取可能为空,默认128,仅限type=chooose或song_url时选填。可选:128:128 码率、320:320 码率、flac:flac码率、high:无损格式、viper_clear:蝰蛇超清音质、viper_atmos:蝰蛇全景声,仅部分音乐支持
withsong string no 是否返回歌曲列表,默认1,即返回,0为不返回,仅限type=rank_list时选填
num string no 歌单返回数量,不建议withsong为1时返回太多,仅限type=rank_list时必填
id string either 歌单ID,仅限type=playlist_detail必填

返回参数

点击文字展开说明

参数名类型说明
codestring状态码
msgstring状态信息
datastring返回数据

查看接口请求/返回示例

接口文档

在线测试 请求模式:

结果将显示在这里

调用示例

<?php
$url = 'https://api.xiaoyu17.cn/API/kg.php';
$params = [
    'apikey' => 'API密钥,注册账号免费获取',
    'type' => '类型,可选:search-搜索歌曲、choose-选择歌曲、song_url-单独获取歌曲链接、rank_list-歌单排行、playlist_detail-歌单详情',
    'word' => '搜索关键词或歌名,仅限type=search或choose必填',
    'choose' => '选择序号,仅限type=choose时必填',
    'page' => '搜索页数,默认1,仅限type=search时选填',
    'pagesize' => '搜索每页返回数量,默认20,仅限type=search时选填',
    'quality' => '音质,如果无法获取可能为空,默认128,仅限type=chooose或song_url时选填。可选:128:128 码率、320:320 码率、flac:flac码率、high:无损格式、viper_clear:蝰蛇超清音质、viper_atmos:蝰蛇全景声,仅部分音乐支持',
    'withsong' => '是否返回歌曲列表,默认1,即返回,0为不返回,仅限type=rank_list时选填',
    'num' => '歌单返回数量,不建议withsong为1时返回太多,仅限type=rank_list时必填',
    'id' => '歌单ID,仅限type=playlist_detail必填',
];
$url .= '?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
import requests

url = "https://api.xiaoyu17.cn/API/kg.php"
params = {
    "apikey": "API密钥,注册账号免费获取",
    "type": "类型,可选:search-搜索歌曲、choose-选择歌曲、song_url-单独获取歌曲链接、rank_list-歌单排行、playlist_detail-歌单详情",
    "word": "搜索关键词或歌名,仅限type=search或choose必填",
    "choose": "选择序号,仅限type=choose时必填",
    "page": "搜索页数,默认1,仅限type=search时选填",
    "pagesize": "搜索每页返回数量,默认20,仅限type=search时选填",
    "quality": "音质,如果无法获取可能为空,默认128,仅限type=chooose或song_url时选填。可选:128:128 码率、320:320 码率、flac:flac码率、high:无损格式、viper_clear:蝰蛇超清音质、viper_atmos:蝰蛇全景声,仅部分音乐支持",
    "withsong": "是否返回歌曲列表,默认1,即返回,0为不返回,仅限type=rank_list时选填",
    "num": "歌单返回数量,不建议withsong为1时返回太多,仅限type=rank_list时必填",
    "id": "歌单ID,仅限type=playlist_detail必填",
}

response = requests.get(url, params=params)
print(response.text)
const url = new URL('https://api.xiaoyu17.cn/API/kg.php');
const params = {
    'apikey': 'API密钥,注册账号免费获取',
    'type': '类型,可选:search-搜索歌曲、choose-选择歌曲、song_url-单独获取歌曲链接、rank_list-歌单排行、playlist_detail-歌单详情',
    'word': '搜索关键词或歌名,仅限type=search或choose必填',
    'choose': '选择序号,仅限type=choose时必填',
    'page': '搜索页数,默认1,仅限type=search时选填',
    'pagesize': '搜索每页返回数量,默认20,仅限type=search时选填',
    'quality': '音质,如果无法获取可能为空,默认128,仅限type=chooose或song_url时选填。可选:128:128 码率、320:320 码率、flac:flac码率、high:无损格式、viper_clear:蝰蛇超清音质、viper_atmos:蝰蛇全景声,仅部分音乐支持',
    'withsong': '是否返回歌曲列表,默认1,即返回,0为不返回,仅限type=rank_list时选填',
    'num': '歌单返回数量,不建议withsong为1时返回太多,仅限type=rank_list时必填',
    'id': '歌单ID,仅限type=playlist_detail必填',
};

Object.keys(params).forEach(key => {
    url.searchParams.append(key, params[key]);
});

fetch(url)
    .then(response => response.text())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));