Podcast RSS API

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

快速体验

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

打开 API 测试工具

鉴权

接口

POST
/api/podcast

解析 RSS 频道基本信息（名称、作者、官网、简介、封面）。请求体：

{
  "url": "https://example.com/feed.xml"
}
POST
/api/podcast/episodes

返回频道信息＋分页后的分集列表（每页 10 条）。请求体：

{
  "url": "https://example.com/feed.xml",
  "page": 1
}

响应示例

{
  "podcast": {
    "name": "示例播客",
    "author": "播客作者",
    "rss": "https://example.com/feed.xml",
    "image": "https://example.com/cover.jpg",
    "website": "https://example.com",
    "description": "<p>频道简介...</p>"
  },
  "pagination": {
    "total": 42,
    "perPage": 10,
    "currentPage": 1,
    "totalPages": 5
  },
  "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": "纯文本简介"
    }
  ]
}

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