Podcast RSS API

提供播客频道概览与分集列表解析服务。所有请求必须携带 X-API-Key 或 ?api_key= 参数。

快速体验

想要直接验证接口？使用浏览器内置的测试工具，支持下拉选择请求结构、填写并记住 API Key。

打开 API 测试工具

鉴权

请求头：X-API-Key: <你的密钥>
或查询参数：?api_key=<你的密钥>
密钥由部署环境中的 API_KEY 控制，未携带或错误会返回 401 Unauthorized。

接口

GET

/api/podcast

解析 RSS 频道基本信息（名称、作者、官网、简介、封面）。查询参数：

/api/podcast?url=https://example.com/feed.xml

可选参数：refresh=1 强制刷新（不走缓存）。

GET

/api/podcast/episodes

返回频道信息＋游标分页后的分集列表。查询参数：

/api/podcast/episodes?url=https://example.com/feed.xml&cursor=0&limit=10

可选参数：refresh=1 强制刷新（不走缓存）。

缓存策略

频道信息：获取到数据时缓存 48 小时；无数据时不缓存。
分集列表：当前页有数据时缓存 36 小时；无数据时不缓存。
传入 refresh=1 可强制刷新并跳过缓存。

响应示例

{
  "podcast": {
    "name": "示例播客",
    "author": "播客作者",
    "rss": "https://example.com/feed.xml",
    "image": "https://example.com/cover.jpg",
    "website": "https://example.com",
    "description": "<p>频道简介...</p>"
  },
  "pagination": {
    "cursor": 0,
    "limit": 10,
    "nextCursor": 10,
    "hasMore": true
  },
  "episodes": [
    {
      "title": "第 1 集",
      "author": "主持人",
      "publishedAt": 1736856000000,
      "duration": "01:02:03",
      "audio": "https://cdn.example.com/audio.mp3",
      "image": "https://example.com/episode.jpg",
      "description": "<p>完整 show notes</p>",
      "intro": "纯文本简介",
      "url": "https://example.com/episode",
      "link": "https://example.com/episode"
    }
  ]
}

说明：分集的 publishedAt 为 Unix 毫秒时间戳，客户端可按东八区等需要自己格式化。