概览
给节目 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 Times | 2026-11-17T11:00:00Z | 2146000 | full |
此外还有单集简介、音频地址、内容分级、分类、封面图、单集页面、单集 GUID、节目 ID、单集 ID 等列。
应用场景
盯竞品的更新节奏,看「发布时间」和「时长」:把同一节目的单集按时间排开,能看出它是日更还是周更、单集体量有没有变,判断对方的产能和投入。
做选题参考,读「单集标题」和「单集简介」:同一分类下的头部节目最近在聊什么,标题里的高频词往往就是这个品类当下的流量入口。
区分内容结构,看「单集类型」:正片、预告、花絮的比例能反映一个节目的运营方式——靠预告拉新的节目和靠正片走量的节目,投放策略完全不同。
做音频归档或转写,用「音频地址」和「时长」:地址是完整音频直链,可以直接拉流做 ASR 或存档;付费专属的单集没有地址,正好能在批量任务里提前筛掉。
适用边界
只采集苹果公开的播客目录信息与公开音频地址,不下载音频文件,不获取付费订阅专属内容,不含听众数据
- 适合用于
- 要建立某个领域播客的单集索引,用于内容检索或选题分析
- 要给播客数据看板供给「最近更新了什么」,按节目定时跑
- 要拿到音频直链做转写、摘要或语料处理(本包只给地址,不代下载)
- 要对比多个同题材节目的更新频率与时长
- 不要用于
- 要听众数、播放量、完播率这类后台才有数据(苹果不公开)
- 要付费订阅专属集的音频(苹果不给地址,只给时长)
- 要节目级的评分、评论量(那是另一个包的事:apple-podcast-show / appstore-reviews)
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1报 no-records 多半是 ID 填错:必须填播客 ID(节目链接里 /id 后面那段),填 App ID 或单集 ID 都会返回 0 条
- 2单个节目最多回 200 集,episodeCount 填更大也只回 200;有的节目本身只存档几十集,就回多少算多少
- 3audio_url 为空通常是该集只对付费订阅者开放,苹果不提供音频地址,时长和标题仍然有值
- 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 同源。
- 节目 ID
podcast_idstring这个单集属于哪个节目(苹果数字 ID),与输入的 podcastIds 对应示例1200361736 - 单集 ID
idstring苹果给这一集的唯一编号(trackId);本包按它去重,同一集不会重复输出示例1000802453646 - 单集标题
episode_namestring单集标题,通常是本期主题;可能带编号前缀示例Democrats Promised Lower Prices. What Can They Actually Do? - 主播 / 作者
artist_namestring节目主创名。苹果在单集行里常常不给这个字段,本包用同一次响应里的节目本体补上示例The New York Times
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"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": {
"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)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。