网易云歌曲收藏数量

接口说明

用于查询网易云歌曲的收藏数量，返回精确数值与展示文案。适合需要在页面中展示歌曲热度或收藏规模的内容场景，无需密钥即可调用。

调用地址

https://mini10.top/api/red_count.php

请求方式

GET

鉴权说明

本接口无需密钥，可直接调用。

请求参数

调用地址：https://mini10.top/api/red_count.php，请求方法：GET。本接口无需密钥，免费调用。

参数取值说明：

• id 需传入字符串形式的歌曲标识，传入非数字内容或格式不符的标识将无法获得有效结果。
• 该参数直接拼接在查询字符串中传递，如 https://mini10.top/api/red_count.php?id=21233962。

成功响应示例

{
  "code": 200,
  "data": {
    "count": 3743,
    "countDesc": "999+"
  }
}

响应字段说明

说明：data.count 为精确数值，data.countDesc 为适合直接展示的简化文案，可按页面需要任选其一使用。

错误响应示例

当请求未能正常完成时，接口返回统一的 JSON 结构，其中 code 固定为 0，msg 为可读的错误描述，errcode 为具体业务错误码。

缺少歌曲 id 参数：

{"code":0,"msg":"缺少必填参数 id","errcode":11012}

接口不存在或地址拼写有误：

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

请求频率超出限制：

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

接口处于维护状态：

{"code":0,"msg":"接口维护中，请稍后再试","errcode":11006}

服务整体暂不可用：

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

业务错误码说明

本接口为免费接口，调用时无需提供密钥，正常不会返回与密钥、积分相关的错误码；若返回 11006、11008、11013、11017 等状态，请稍后重试或核对调用地址与请求方式。

调用示例

终端 curl（bash）

curl -X GET "https://mini10.top/api/red_count.php?id=21233962"

PHP

// PHP 示例：请求网易云歌曲收藏数量
$url = "https://mini10.top/api/red_count.php?id=21233962";

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

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

$data = json_decode($response, true);
echo $data['data']['countDesc'];

注意事项

• 调用地址固定：请原样使用 https://mini10.top/api/red_count.php，并通过 HTTPS 访问，不要把地址改为 HTTP，也不要省略路径，否则可能无法正常获取数据。
• id 参数格式：id 必须是歌曲的数字 ID 字符串（如 21233962），不要传入歌曲链接、歌单 ID 或带 &、? 等符号的拼接内容；如果 id 为空或不是纯数字，请求将无法返回有效收藏数量。
• 无需密钥：本接口不校验任何密钥，请求中不必也不应附带密钥、令牌或其它身份信息；请勿在请求里放置与本接口无关的敏感参数。
• 合理控制频率：本接口免费开放，但请勿对同一 id 高频轮询，也请勿一次性批量并发大量请求；展示场景建议设置缓存（如数分钟至数十分钟），以降低无效请求对服务的影响。
• 结果判断：请以返回体中的 code 为 200 作为成功依据；count 为数值型收藏量，countDesc 为展示用文本（如 999+）。前端展示建议优先使用 countDesc，需要精确计算时再使用 count。
• 空值与异常处理：若歌曲不存在、已下架或 id 错误，返回的 data 可能为空或字段缺失，调用方应做判空与兜底展示，避免页面报错。
• 数据时效性：收藏数量为查询时刻的结果，会随歌曲热度变化，不应作为长期不变的静态值写入本地数据库。