logo

Apple Podcasts 单集采集

按节目 ID 或节目链接采集 Apple Podcasts 的单集:标题、主播、发布时间、时长、完整简介、可直接下载的音频地址、封面、单集页面、GUID 与分级,一次可跑多个节目

发布者
价格
¥0.0349 / 条
最近更新
2026-11-18

概览

给节目 ID,把 Apple Podcasts 的单集取成一张表,一集一行,共 14 列。

数据说明

数据来自苹果公开的播客目录。输入的是节目(podcast)的数字 ID,取到的是它已发布的单集:标题、主播、发布时间、时长、简介、音频地址、分类、封面、单集页面、GUID 与单集类型。一个节目最多回 200 集;有的节目在苹果目录里本来就只存档了几十集(The Daily 只有 45 集),这时填更大的数量也只回这些。

几列容易看错:「时长」按毫秒记,不是秒;「音频地址」是可直接下载的完整音频,不是试听片段——付费订阅专属的单集苹果不给地址,该列为空,但标题、时长、简介照常有值。「主播 / 作者」不是单集行自带的:苹果的单集数据经常不给这一项,程序从同一次响应里的节目信息补上;个别节目连节目本体也取不到时退成节目名。

「单集类型」(正片 / 预告 / 花絮)苹果接口不提供,程序会额外读一次节目自己的 RSS,按 GUID → 音频地址 → 标题逐级比对填上;feed 读不到、超过 20MB、或这一集不在 feed 里时,退回 podcast-episode,表示类型未核实到。「内容分级」多数为空,苹果只在部分单集标注 Clean / Explicit。

覆盖范围只含公开的单集信息与音频地址:不下载音频文件,不取付费订阅专属内容,不含听众数据。

结果长什么样

每条记录是一集:

单集标题主播 / 作者发布时间时长(毫秒)单集类型
Democrats Promised Lower Prices…The New York Times2026-11-17T11:00:00Z2146000full

此外还有单集简介、音频地址、内容分级、分类、封面图、单集页面、单集 GUID、节目 ID、单集 ID 等列。

应用场景

盯竞品的更新节奏,看「发布时间」和「时长」:把同一节目的单集按时间排开,能看出它是日更还是周更、单集体量有没有变,判断对方的产能和投入。

做选题参考,读「单集标题」和「单集简介」:同一分类下的头部节目最近在聊什么,标题里的高频词往往就是这个品类当下的流量入口。

区分内容结构,看「单集类型」:正片、预告、花絮的比例能反映一个节目的运营方式——靠预告拉新的节目和靠正片走量的节目,投放策略完全不同。

做音频归档或转写,用「音频地址」和「时长」:地址是完整音频直链,可以直接拉流做 ASR 或存档;付费专属的单集没有地址,正好能在批量任务里提前筛掉。

适用边界

只采集苹果公开的播客目录信息与公开音频地址,不下载音频文件,不获取付费订阅专属内容,不含听众数据

  • 适合用于
  • 要建立某个领域播客的单集索引,用于内容检索或选题分析
  • 要给播客数据看板供给「最近更新了什么」,按节目定时跑
  • 要拿到音频直链做转写、摘要或语料处理(本包只给地址,不代下载)
  • 要对比多个同题材节目的更新频率与时长
  • 不要用于
  • 要听众数、播放量、完播率这类后台才有数据(苹果不公开)
  • 要付费订阅专属集的音频(苹果不给地址,只给时长)
  • 要节目级的评分、评论量(那是另一个包的事:apple-podcast-show / appstore-reviews)

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1报 no-records 多半是 ID 填错:必须填播客 ID(节目链接里 /id 后面那段),填 App ID 或单集 ID 都会返回 0 条
  2. 2单个节目最多回 200 集,episodeCount 填更大也只回 200;有的节目本身只存档几十集,就回多少算多少
  3. 3audio_url 为空通常是该集只对付费订阅者开放,苹果不提供音频地址,时长和标题仍然有值
  4. 4多个节目一起跑时,某个节目取不到只会跳过并记日志,不影响其他节目出数

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 节目 ID 或链接podcastIds选填array<string>
    必须是 JSON 数组,形如 ["1200361736"]。数字 ID 或节目链接(https://podcasts.apple.com/us/podcast/the-daily/id1200361736)都行。最多 50 个节目
    示例["1200361736"]
  • 每个节目取多少集episodeCount选填integer
    从最新一集往回取。苹果单节目上限 200 集(传更大的值也只会回 200);有的节目本身只有几十集,就回多少算多少
    范围1–2000默认值100

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 节目 IDpodcast_idstring
    这个单集属于哪个节目(苹果数字 ID),与输入的 podcastIds 对应
    示例1200361736
  • 单集 IDidstring
    苹果给这一集的唯一编号(trackId);本包按它去重,同一集不会重复输出
    示例1000802453646
  • 单集标题episode_namestring
    单集标题,通常是本期主题;可能带编号前缀
    示例Democrats Promised Lower Prices. What Can They Actually Do?
  • 主播 / 作者artist_namestring
    节目主创名。苹果在单集行里常常不给这个字段,本包用同一次响应里的节目本体补上
    示例The New York Times

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "podcast_id": "1200361736",
  "id": "1000802453646",
  "episode_name": "Democrats Promised Lower Prices. What Can They Actually Do?",
  "artist_name": "The New York Times",
  "release_date": "2026-11-17T11:00:00Z",
  "duration_ms": 2146000,
  "description": "Democrats promised to lower prices...",
  "audio_url": "https://dts.podtrac.com/redirect.mp3/nyt.simplecastaudio.com/.../default.mp3",
  "content_rating": "Clean",
  "genres": "[\"News\"]",
  "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/.../600x600bb.jpg",
  "episode_url": "https://podcasts.apple.com/us/podcast/x/id1200361736?i=1000802453646",
  "guid": "e4225d06-e238-11f1-8b63-ab796739cefe",
  "kind": "full"
}

调用方式

本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/apple-podcast-episodes",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

每次运行

每提交一次任务计费一次,与返回条数无关。

¥0.0004/ 次
按条计费

按实际成功返回的数据条数计费,任务失败不计费。

¥0.0349/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.0349 / 条