网易云歌曲播放信息

接口说明

查询指定网易云歌曲的播放信息，用于获取歌曲的可播放状态与音质相关权限数据。适合需要展示或判断歌曲播放条件的音乐类应用调用。

调用地址

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

请求方式

GET

鉴权说明

本接口无需密钥，可直接调用，且不产生费用。

请求参数

调用地址：https://mini10.top/api/privilege.php，请求方式：GET。本接口无需密钥，可直接调用。

参数取值说明：

• ids 必须是纯数字的歌曲 id，不要包含空格或中文逗号。
• 批量查询时建议单次传入数量不宜过多，以免请求地址过长。
• 返回结果中的歌曲顺序与传入 id 的顺序不一定一致，可按返回项中的 id 字段对应。

成功响应示例

{
  "data": [
    {
      "id": 21233962,
      "fee": 0,
      "payed": 0,
      "st": -100,
      "pl": 0,
      "dl": 0,
      "sp": 7,
      "cp": 0,
      "subp": 1,
      "cs": false,
      "maxbr": 999000,
      "fl": 0,
      "toast": false,
      "flag": 4,
      "preSell": false,
      "playMaxbr": 999000,
      "downloadMaxbr": 999000,
      "maxBrLevel": "lossless",
      "playMaxBrLevel": "lossless",
      "downloadMaxBrLevel": "lossless",
      "plLevel": "none",
      "dlLevel": "none",
      "flLevel": "none",
      "rscl": 0,
      "freeTrialPrivilege": {
        "resConsumable": true,
        "userConsumable": false,
        "listenType": null,
        "cannotListenReason": 1,
        "playReason": null,
        "freeLimitTagType": null
      },
      "rightSource": 0,
      "chargeInfoList": [
        {
          "rate": 128000,
          "chargeUrl": null,
          "chargeMessage": null,
          "chargeType": 1
        },
        {
          "rate": 192000,
          "chargeUrl": null,
          "chargeMessage": null,
          "chargeType": 1
        },
        {
          "rate": 320000,
          "chargeUrl": null,
          "chargeMessage": null,
          "chargeType": 1
        },
        {
          "rate": 999000,
          "chargeUrl": null,
          "chargeMessage": null,
          "chargeType": 1
        }
      ],
      "code": 0,
      "message": null,
      "plLevels": null,
      "dlLevels": null,
      "ignoreCache": null,
      "bd": null
    }
  ],
  "code": 200
}

响应字段说明

data 数组元素字段：

freeTrialPrivilege 对象字段：

chargeInfoList 数组元素字段：

错误响应示例

接口在参数缺失、接口不存在或服务异常等情况下，会返回统一的 JSON 错误结构。响应体固定包含 code、msg、errcode 三个字段：code 为响应状态标识，msg 为可读的错误说明，errcode 为业务错误码。

{
  "code": 0,
  "msg": "请求参数错误",
  "errcode": 11012
}

当所请求的接口处于维护状态时，返回示例：

{
  "code": 0,
  "msg": "接口维护中",
  "errcode": 11006
}

当服务整体暂不可用时，返回示例：

{
  "code": 0,
  "msg": "服务暂不可用",
  "errcode": 11017
}

业务错误码说明

以下为本站全部业务错误码。返回体中 code 为 0 且携带 errcode 字段时，即表示调用未成功，请根据 errcode 对照下表排查。

说明：本接口为免费接口，无需提供密钥即可调用，因此通常不会返回与密钥、积分相关的错误码；若出现此类错误码，表示请求经由需鉴权的调用方式发起或接口配置发生变更，可对照上表定位。参数缺失或格式不正确时，一般返回 11012；调用地址拼写错误时返回 11013；请求方式与本接口要求的 GET 不一致时返回 11018；接口数据获取异常时返回 11016 或 11017。

调用示例

终端 curl（bash）

curl "https://mini10.top/api/privilege.php?ids=21233962"

批量查询多首歌曲时，使用英文逗号分隔歌曲 id：

curl "https://mini10.top/api/privilege.php?ids=21233962,1824020872"

PHP

// PHP 调用示例
$url = "https://mini10.top/api/privilege.php?ids=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);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo "请求失败: " . curl_error($ch);
} else {
    echo "HTTP 状态码: " . $httpCode . PHP_EOL;
    $data = json_decode($response, true);
    print_r($data);
}

curl_close($ch);

注意事项

• 本接口无需密钥，调用地址中不携带任何鉴权参数；请勿自行附加来源不明的密钥或身份参数，以免请求被拒绝。
• ids 为必填参数，取值为歌曲数字 ID 的字符串形式。批量查询时多个 ID 使用英文半角逗号 , 分隔，逗号前后不要加空格，也不要使用中文逗号或其它分隔符。
• 单次批量查询的 ID 数量建议控制在 100 个以内。一次传入过多 ID 会增加响应时间并可能触发限流；需要查询大量歌曲时，请分批请求，并在批次之间留出间隔。
• 请使用 HTTPS 访问。GET 请求的参数需按 URL 规范进行编码；ids 虽以数字为主，仍建议统一编码，避免拼接异常。
• 接口免费，但请合理控制调用频率，避免高频轮询或并发压测。相同 ID 的重复查询建议在本地做短时缓存，以减少不必要的请求。
• 返回 code 为 200 仅表示本次请求处理成功；具体到每首歌曲的可播放状态，需结合 data 数组中该条目的多项字段综合判断，不要只依赖单一字段下结论。
• 歌曲的版权与可播放状态会随时间变化，返回结果具有时效性，不宜作为长期固定的数据源缓存或对外承诺。个别 ID 不存在或已下架时，对应位置可能缺少有效信息，调用方需做空值与异常容错。
• 请勿将本接口返回的数据用于侵犯版权或违反相关平台条款的用途，转载或展示时请遵守内容来源方的要求。