基础信息
查看接口基本信息和返回格式 接口描述
获取酷我音乐各类排行榜歌曲信息,支持翻页,返回高清封面和付费类型
七日请求统计
本周总请求: -
日均: -
请求方式
GET
POST 推荐
请求地址
https://api.cxzja.cn/api/kwbd
返回方式
JSON
默认返回格式,包含完整数据结构
返回预览
JSON
{
"code": 200,
"msg": "请求成功",
"data": {
"榜单ID": 93,
"榜单名称": "飙升榜",
"页码": 1,
"每页数量": 30,
"歌曲总数": 30,
"预设榜单映射": {
"新歌榜": 17,
"飙升榜": 93,
"抖音热歌榜": 158,
"万物DJ榜": 176,
"会员畅听榜": 145
},
"歌曲列表": [
{
"序号": 1,
"歌曲ID": "567247828",
"歌曲名": "你有没有真的爱过我",
"歌手": "阿图表妹(ID:20310975)",
"专辑": "你有没有真的爱过我(ID:91992117)",
"时长": "04:03",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s54/51/1818397081.jpg",
"付费类型": "VIP"
},
{
"序号": 2,
"歌曲ID": "567245560",
"歌曲名": "你有没有真的爱过我 (烟嗓版)",
"歌手": "寂寞阿图(ID:19676031)",
"专辑": "你有没有真的爱过我(ID:91992058)",
"时长": "03:45",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s8/9/2109914311.jpg",
"付费类型": "VIP"
},
{
"序号": 3,
"歌曲ID": "28509807",
"歌曲名": "无人之岛",
"歌手": "任然(ID:22196)",
"专辑": "没有发生的爱情(ID:3989854)",
"时长": "04:45",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/13/6/1934684073.jpg",
"付费类型": "VIP"
},
{
"序号": 4,
"歌曲ID": "9820530",
"歌曲名": "依兰爱情故事",
"歌手": "方天雷&贾玲(ID:4643)",
"专辑": "依兰爱情故事(ID:1349995)",
"时长": "04:52",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/60/21/1225426553.jpg",
"付费类型": "VIP"
},
{
"序号": 5,
"歌曲ID": "622510397",
"歌曲名": "岁月如笔写春秋(DJ默涵版)",
"歌手": "花姐(ID:992315)",
"专辑": "岁月如笔写春秋(ID:96530252)",
"时长": "03:24",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s41/12/1152641188.jpg",
"付费类型": "VIP"
},
{
"序号": 6,
"歌曲ID": "617069861",
"歌曲名": "吹吹山顶的风",
"歌手": "巴扎黑(ID:11060460)",
"专辑": "吹吹山顶的风(ID:96659804)",
"时长": "02:59",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s86/34/2068145133.jpg",
"付费类型": "免费"
},
{
"序号": 7,
"歌曲ID": "133360",
"歌曲名": "樱花草",
"歌手": "Sweety(ID:1010)",
"专辑": "花言乔语 (精装版)(ID:8975)",
"时长": "04:43",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s24/5/661213926.jpg",
"付费类型": "VIP"
},
{
"序号": 8,
"歌曲ID": "620065344",
"歌曲名": "樱花草 (R&B版)",
"歌手": "阿野(ID:18976201)",
"专辑": "樱花草(R&B版)(ID:96801830)",
"时长": "02:49",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s46/30/1486407554.jpg",
"付费类型": "VIP"
},
{
"序号": 9,
"歌曲ID": "20273751",
"歌曲名": "繁花",
"歌手": "董真(ID:1817)",
"专辑": "三生三世十里桃花 电视剧原声专辑(ID:7029173)",
"时长": "03:45",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s45/88/2992154346.jpg",
"付费类型": "VIP"
},
{
"序号": 10,
"歌曲ID": "21762578",
"歌曲名": "一生所爱",
"歌手": "卢冠廷&莫文蔚(ID:690)",
"专辑": "齐天周大圣之西游双记 电影歌乐游唱版(ID:4168738)",
"时长": "04:33",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s6/60/2253976401.jpg",
"付费类型": "VIP"
},
{
"序号": 11,
"歌曲ID": "228258581",
"歌曲名": "星河叹",
"歌手": "黄龄(ID:1509)",
"专辑": "星河叹(ID:29984150)",
"时长": "04:24",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/3/82/730524348.jpg",
"付费类型": "VIP"
},
{
"序号": 12,
"歌曲ID": "618171205",
"歌曲名": "红尘慌慌",
"歌手": "周深(ID:195793)",
"专辑": "红尘慌慌(ID:96703270)",
"时长": "04:33",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s75/16/3745758087.jpg",
"付费类型": "免费"
},
{
"序号": 13,
"歌曲ID": "3620537",
"歌曲名": "你还要我怎样",
"歌手": "薛之谦(ID:947)",
"专辑": "意外(ID:288019)",
"时长": "05:10",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/39/42/1467983488.jpg",
"付费类型": "VIP"
},
{
"序号": 14,
"歌曲ID": "604712162",
"歌曲名": "爱而不得弃而不舍 (对唱版)",
"歌手": "岁月静美&阿文(ID:2473685)",
"专辑": "爱而不得弃而不舍(对唱版)(ID:95534900)",
"时长": "03:05",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s44/71/3651020754.jpg",
"付费类型": "VIP"
},
{
"序号": 15,
"歌曲ID": "621949827",
"歌曲名": "讨厌 (Live)",
"歌手": "杨丞琳&欧阳娜娜(ID:223)",
"专辑": "天赐的声音第七季 第5期(ID:97045787)",
"时长": "04:02",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s91/90/1383606458.jpg",
"付费类型": "免费"
},
{
"序号": 16,
"歌曲ID": "607549891",
"歌曲名": "你有没有真的爱过我 (合唱版)",
"歌手": "阿图表妹&寂寞阿图(ID:20310975)",
"专辑": "你有没有真的爱过我(ID:91992117)",
"时长": "04:03",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s54/51/1818397081.jpg",
"付费类型": "VIP"
},
{
"序号": 17,
"歌曲ID": "1044318",
"歌曲名": "黄昏",
"歌手": "周传雄(ID:2)",
"专辑": "Transfer(ID:63488)",
"时长": "05:44",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s49/14/2320162909.jpg",
"付费类型": "VIP"
},
{
"序号": 18,
"歌曲ID": "597051189",
"歌曲名": "若今生无缘 (若今生已无缘)",
"歌手": "万海东(ID:197256)",
"专辑": "若今生无缘 (若今生已无缘)(ID:94653800)",
"时长": "03:40",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s29/56/3302138584.jpg",
"付费类型": "VIP"
},
{
"序号": 19,
"歌曲ID": "611237221",
"歌曲名": "甲乙丙丁 (你我怎么两清)",
"歌手": "李佳薇(ID:21166)",
"专辑": "甲乙丙丁(ID:96257394)",
"时长": "03:30",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s21/72/840798623.jpg",
"付费类型": "免费"
},
{
"序号": 20,
"歌曲ID": "605489629",
"歌曲名": "Steal The Moon",
"歌手": "王俊凯(ID:123557)",
"专辑": "WJK(ID:88444486)",
"时长": "03:36",
"专辑封面": "http://img4.kuwo.cn/pic_music/700/s4s40/81/3662895825.jpg",
"付费类型": "免费"
},
{
"序号": 21,
"歌曲ID": "1161224",
"歌曲名": "烟火",
"歌手": "吴奇隆(ID:959)",
"专辑": "霹雳暴风(ID:66812)",
"时长": "04:59",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s87/29/462182535.jpg",
"付费类型": "免费"
},
{
"序号": 22,
"歌曲ID": "560009002",
"歌曲名": "可惜春风不懂我伤悲 (烟嗓版)",
"歌手": "万能和弦(ID:3417343)",
"专辑": "可惜春风不懂我伤悲(烟嗓版)(ID:90160368)",
"时长": "03:44",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s35/96/1941017864.jpg",
"付费类型": "VIP"
},
{
"序号": 23,
"歌曲ID": "505916587",
"歌曲名": "无人的岛",
"歌手": "张诗文(ID:4813968)",
"专辑": "无人的岛(ID:77413493)",
"时长": "03:07",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s62/78/1866243110.jpg",
"付费类型": "VIP"
},
{
"序号": 24,
"歌曲ID": "1697454",
"歌曲名": "盛夏的果实",
"歌手": "莫文蔚(ID:909)",
"专辑": "NO.1新曲精选全记录20首(ID:64540)",
"时长": "04:11",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s49/58/3052577581.jpg",
"付费类型": "VIP"
},
{
"序号": 25,
"歌曲ID": "160373899",
"歌曲名": "沈园外",
"歌手": "阿YueYue&戾格&小田音乐社(ID:1036836)",
"专辑": "沈园外(ID:17273045)",
"时长": "03:43",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s38/14/103150539.jpg",
"付费类型": "VIP"
},
{
"序号": 26,
"歌曲ID": "71401250",
"歌曲名": "陪你去流浪",
"歌手": "薛之谦(ID:947)",
"专辑": "尘(ID:10267984)",
"时长": "04:34",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/13/92/1024436502.jpg",
"付费类型": "VIP"
},
{
"序号": 27,
"歌曲ID": "614002910",
"歌曲名": "依兰爱情故事",
"歌手": "金志文(ID:5208)",
"专辑": "依兰爱情故事(ID:96509978)",
"时长": "04:52",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s39/10/2796916474.jpg",
"付费类型": "免费"
},
{
"序号": 28,
"歌曲ID": "27352695",
"歌曲名": "街道",
"歌手": "林俊杰(ID:1062)",
"专辑": "JJ陆(ID:29534)",
"时长": "04:02",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s61/79/3864206498.jpg",
"付费类型": "VIP"
},
{
"序号": 29,
"歌曲ID": "622577072",
"歌曲名": "岁月如笔写春秋(DJ版)",
"歌手": "吕口口(ID:290854)",
"专辑": "岁月如笔写春秋-走心女版(ID:95324328)",
"时长": "03:30",
"专辑封面": "http://img1.kwcdn.kuwo.cn/star/albumcover/700/s4s23/49/948843496.jpg",
"付费类型": "VIP"
},
{
"序号": 30,
"歌曲ID": "440571493",
"歌曲名": "租购",
"歌手": "薛之谦(ID:947)",
"专辑": "守村人(ID:61469277)",
"时长": "04:30",
"专辑封面": "http://img4.kuwo.cn/pic_music/700/s4s64/70/3163129698.jpg",
"付费类型": "VIP"
}
],
"api_source": "API官网:api.cxzja.cn",
"timestamp": "2026-07-15 09:39:18"
}
}计费标准
了解接口的计费方式和价格
免费接口
免费
完全免费
所有用户均可免费调用,无需付费
QPS限制
普通用户
不限
会员用户
不限
每日请求次数
普通用户
不限
会员用户
不限
安全认证
了解接口的认证方式和访问凭证管理 Token 认证
实名认证
无需实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
推荐
Header 认证
通过 HTTP Header 传递认证信息
Authorization
Bearer {access_token}或通过curl请求参数传递:
curl
curl "https://api.cxzja.cn/api/kwbd?token=YOUR_TOKEN"
参数文档
查看接口请求参数和返回字段说明 请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
| token | string | 必填 | 无 | 登录后显示你的请求token | 接口请求唯一认证标识! |
| mode | string | 可选 | json | json | 返回格式 |
| id | string | 必填 | 酷我音乐榜单ID,纯整数格式 | ||
| page | string | 必填 | 分页页码,最小为1,从1开始计数 | ||
| limit | string | 必填 | 每页歌曲数量,取值范围1-100 |
返回参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code
|
int | 返回状态码 |
状态码
了解接口返回的状态码含义及处理方式 接口状态码
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 201 | 请求失败 |
服务器状态码
| 状态码 | 说明 |
|---|---|
| 500 | 服务器错误 |
| 501 | 请求接口不存在 |
| 502 | 请求接口已下架 |
| 503 | 请求接口维护中 |
| 504 | 缺少请求token参数 |
| 505 | 请求token不存在 |
| 506 | 请求token已被封禁 |
| 507 | 请求token额度不足 |
| 508 | 今日请求token已达上限 |
| 509 | 请求ip不在token白名单内 |
| 510 | 请求token无权使用当前接口 |
| 511 | 接口请求频率过高,请稍后再试 |
| 512 | 该接口未开启在线测试功能 |
| 513 | 今日在线测试次数已达上限 |
| 514 | 今日该接口请求次数已达上限 |
| 515 | 该接口为会员专属接口,请携带会员token |
| 516 | 该接口为会员专属接口,请开通会员 |
| 517 | 接口请求过于频繁,已被临时限制 |
| 518 | 该接口需要实名认证,请先完成实名认证 |
| 519 | 当前Token今日请求次数已达上限 |
| 520 | 当前Token已被禁止使用 |
| 521 | 请求token余额不足 |
| 522 | 请求token额度和余额均不足 |
| 530 | 接口服务异常,请稍后再试 |
| 531 | 接口响应超时 |
| 532 | 接口返回数据格式错误 |
| 533 | 接口请求失败 |
在线测试
在线调试接口,实时查看响应结果 发起请求
GET/POST
示例代码
多种语言的接口调用示例PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言
PHP
<?php
$API_TOKEN = 'YOUR_TOKEN';
$API_URL = 'https://api.cxzja.cn/api/kwbd';
$params = array(
'token' => 'YOUR_TOKEN',
'mode' => 'json',
'id' => '参数值',
'page ' => '参数值',
'limit' => '参数值',
);
$res = api::send($API_URL, $params, 'GET/POST');
print($res);
class api {
public static function send($url, $data, $type) {
$data = http_build_query($data);
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
} else {
curl_setopt($ch, CURLOPT_URL, $url . '?' . $data);
}
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$res = curl_exec($ch);
curl_close($ch);
return $res;
}
}JavaScript
$.ajax({
url: 'https://api.cxzja.cn/api/kwbd',
data: {
token: 'YOUR_TOKEN',
mode: 'json',
id: '参数值',
page : '参数值',
limit: '参数值',
},
type: 'GET/POST',
dataType: 'json',
success: function(data) {
console.log(data);
},
error: function(err) {
console.log('请求失败', err);
}
});Python
import requests
url = "https://api.cxzja.cn/api/kwbd"
data = {
"token": "YOUR_TOKEN",
"mode": "json",
"id": "参数值",
"page ": "参数值",
"limit": "参数值",
}
response = requests.post(url, data=data)
print(response.json())Java
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;
public class ApiRequest {
public static void main(String[] args) throws Exception {
URL url = new URL("https://api.cxzja.cn/api/kwbd");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET/POST");
conn.setConnectTimeout(10000);
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream()));
String line;
StringBuilder result = new StringBuilder();
while ((line = reader.readLine()) != null) {
result.append(line);
}
reader.close();
System.out.println(result.toString());
}
}Go
package main
import (
"fmt"
"io/ioutil"
"net/http"
"strings"
)
func main() {
data := "token=YOUR_TOKEN&mode=json&id=%E5%8F%82%E6%95%B0%E5%80%BC&page+=%E5%8F%82%E6%95%B0%E5%80%BC&limit=%E5%8F%82%E6%95%B0%E5%80%BC"
resp, _ := http.Post("https://api.cxzja.cn/api/kwbd",
"application/x-www-form-urlencoded", strings.NewReader(data))
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}C#
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
using var client = new HttpClient();
var data = new FormUrlEncodedContent(new Dictionary<string, string> {
{"token", "YOUR_TOKEN"},
{"mode", "json"},
{"id", "参数值"},
{"page ", "参数值"},
{"limit", "参数值"},
});
var response = await client.PostAsync("https://api.cxzja.cn/api/kwbd", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(response);
}
}NodeJs
const https = require('https');
const querystring = require('querystring');
const postData = querystring.stringify({
'token': 'YOUR_TOKEN',
'mode': 'json',
'id': '参数值',
'page ': '参数值',
'limit': '参数值',
});
const options = {
hostname: 'api.cxzja.cn',
path: '/api/kwbd',
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
};
const req = https.request(options, res => {
let data = '';
res.on('data', d => data += d);
res.on('end', () => console.log(data));
});
req.write(postData);
req.end();
C
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>
static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
((char*)userp)[0] = '\0';
strcat(userp, contents);
return size * nmemb;
}
int main() {
CURL *curl;
CURLcode res;
char response[4096] = {0};
curl_global_init(CURL_GLOBAL_DEFAULT);
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/kwbd");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&id=%E5%8F%82%E6%95%B0%E5%80%BC&page+=%E5%8F%82%E6%95%B0%E5%80%BC&limit=%E5%8F%82%E6%95%B0%E5%80%BC");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) printf("%s\n", response);
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}C++
#include <iostream>
#include <string>
#include <curl/curl.h>
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
userp->append((char*)contents, size * nmemb);
return size * nmemb;
}
int main() {
CURL* curl = curl_easy_init();
std::string response;
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://api.cxzja.cn/api/kwbd");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&id=%E5%8F%82%E6%95%B0%E5%80%BC&page+=%E5%8F%82%E6%95%B0%E5%80%BC&limit=%E5%8F%82%E6%95%B0%E5%80%BC");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
CURLcode res = curl_easy_perform(curl);
if (res == CURLE_OK) std::cout << response << std::endl;
curl_easy_cleanup(curl);
}
curl_global_cleanup();
return 0;
}易语言
.版本 2 .支持库 spec .局部变量 url, 文本型 .局部变量 params, 文本型 .局部变量 result, 文本型 url = "https://api.cxzja.cn/api/kwbd" params = "token=YOUR_TOKEN&mode=json&id=%E5%8F%82%E6%95%B0%E5%80%BC&page+=%E5%8F%82%E6%95%B0%E5%80%BC&limit=%E5%8F%82%E6%95%B0%E5%80%BC" result = 编码_URL解码 (网页_访问 (url, , params)) 调试输出 (result)
AI开发文档
导出接口文档供AI助手快速理解接口结构
复制下方内容粘贴给AI助手,即可快速生成对接代码。
JSON 格式
0 KB