参数名	类型	必填	说明
key	string	是	接口调用密钥
action	string	是	search,detail,audio
keyword	string	否
page	string	否

央视听音

接口说明

本接口提供央视音频内容的检索、详情获取及播放地址查询功能。适用于需要集成央视音视频资料的开发场景。

调用地址

https://api.vsaa.cn/api/book/cctv-audio/index.php

请求方式

支持 GET 和 POST 两种请求方法。调用者可根据自身工程习惯选择任意一种发起请求。GET 请求通常将参数拼接在 URL 查询字符串中；POST 请求可将参数置于请求体中（建议采用表单或 JSON 格式，具体需与客户端序列化逻辑保持一致）。两种方法在功能表现、返回数据及鉴权逻辑上完全等价，不存在方法层面的功能差异。

鉴权说明

本接口采用 Query 参数 进行身份认证。请在 URL 查询字符串中携带 key 参数，其值为您的专属接口调用密钥。

传递方式：将 key 作为标准查询参数附加在调用地址末尾，例如：?key=您的密钥值&action=search。
必填要求：key 为强制字段。缺失该参数、参数值为空或密钥无效时，接口将拒绝访问并返回鉴权失败提示。
安全性提示：由于 Query 参数在日志、浏览器历史记录及网络抓包中可能明文可见，建议在服务端直接构造请求或使用 HTTPS 加密传输通道，避免将完整 URL 暴露在前端客户端代码中。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 参数传递。
action	string	是	操作类型，取值范围：`search`（搜索）、`detail`（详情）、`audio`（音频）。
keyword	string	否	搜索关键词，在 `action` 为 `search` 时建议提供。
page	string	否	分页页码，用于获取指定页面的数据。

成功响应示例

{
  "code": 0,
  "data": {
    "isEnd": true,
    "data": [
      {
        "id": "VIDAL5OjoYvTckOoOcgmQ6g8201019",
        "title": "争地失了手足情",
        "artwork": "https://p2.img.cctvpic.com/fmspic/2021/06/20/95e430d0bfcf47b29822026ef9b832f5-33367185-1.jpg",
        "description": "本期节目主要内容：老徐头共有三个儿女，徐占全排行老大，小时候因为家里穷，徐占全早早辍学务工，后来徐占全自己种果树开果园，随着果园生意越来越好，徐占全也开始痴迷风水占卜。"
      },
      {
        "id": "VIDAL5OjoYvTckOoOcgmQ6g8201019",
        "title": "求转运落圈套",
        "artwork": "https://p5.img.cctvpic.com/fmspic/2020/04/09/5808dc681ab6466389519363314c9668-19.jpg",
        "description": "本期节目主要内容： 李玉在一次公司的商务晚宴上遇到了业界非常知名的风水大师。"
      }
    ]
  }
}

响应字段说明

字段名	类型	说明
code	integer	状态码，`0` 表示请求成功。
data	object	响应数据主体。
data.isEnd	boolean	分页状态标识，`true` 表示当前为最后一页或无更多数据，`false` 表示还有更多数据。
data.data	array	音频列表数组，包含本次请求返回的具体音频条目。
data.data[].id	string	音频资源唯一标识符。
data.data[].title	string	音频标题。
data.data[].artwork	string	音频封面图片的 URL 地址。
data.data[].description	string	音频内容的简要描述或节目主要内容。

错误响应示例

当接口调用失败时，系统将返回统一的 JSON 格式错误信息。code 字段固定为 0，msg 字段包含具体的错误描述，errcode 字段标识具体的业务错误类型。

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

业务错误码说明

调用本站接口时，可能返回以下业务错误码。请根据 errcode 值排查请求配置、密钥状态或系统运行状况。

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足
11025	该密钥无权调用此接口

调用示例

终端 curl（bash）

curl -G "https://api.vsaa.cn/api/book/cctv-audio/index.php" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=search" \
  --data-urlencode "keyword=风水" \
  --data-urlencode "page=1"

PHP

// PHP
$apiKey = 'YOUR_API_KEY';
$endpoint = 'https://api.vsaa.cn/api/book/cctv-audio/index.php';

$params = http_build_query([
    'key' => $apiKey,
    'action' => 'search',
    'keyword' => '风水',
    'page' => '1',
]);

$ch = curl_init($endpoint . '?' . $params);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo json_encode($result, JSON_UNESCAPED_UNICODE, JSON_PRETTY_PRINT);

注意事项

密钥安全：调用密钥 key 为必填参数，严禁硬编码在前端 JavaScript、客户端 App 源码或公开仓库中。建议将密钥配置在服务端，由后端发起请求；前端应用仅通过服务端中转或代理调用，避免密钥暴露导致账号被恶意盗用。
HTTPS 强制：必须使用 HTTPS 协议发起请求，确保密钥及传输数据在链路层加密，防止中间人窃听或篡改。
频率限制：接口当前频率限制约为 每分钟 56 次。请在应用层实现限流机制（如令牌桶或滑动窗口），避免高频并发调用导致触发限流或账号临时封禁。建议对非实时场景添加缓存逻辑，减少重复请求。
参数校验：
- action 字段必须严格传入 search、detail 或 audio 三者之一，拼写错误或缺失将导致请求失败。
- keyword 与 page 为可选参数，但在执行 search 操作时建议明确传入关键词及页码，以避免返回默认或空数据。
返回内容处理：接口返回 JSON 格式数据，外层 code 为 0 表示成功。data 数组中包含央视音频节目的元信息（如 id、title、artwork、description）。请注意 artwork 字段为外部 CDN 图片链接，前端渲染时需处理好图片加载失败的回退方案，且注意版权合规。
错误重试：若因网络波动或短暂服务异常导致请求失败，建议实现指数退避重试机制，但需确保重试间隔符合频率限制要求，避免雪崩效应。
无鉴权 Header：本接口不支持通过 Header 传递密钥，仅支持 Query 参数方式。请勿尝试在 Authorization 或其他 Header 中携带密钥，否则可能导致鉴权失败。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

央视听音

接口信息

请求参数

返回示例

详细文档

央视听音

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

蜻蜓FM