logo

Apple Podcasts 采集

一个包覆盖苹果播客七种采集:关键词搜节目、节目详情(含发布者邮箱与更新频率)、听众评论、分国家榜单、节目单集(含集号季号与转写链接)、发布者名下全部节目、按关键词搜单集

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

概览

一个包覆盖苹果播客的七种采集,结果全部落在同一张 71 列的宽表里,靠「行类型」区分这一行是节目、榜单、单集还是评论。

数据说明

七种采集方式是:搜节目、查单个节目、取听众评论、看分国家分分类的榜单、列某个节目的单集、按发布者列其名下全部节目、按关键词搜单集。结果都进同一张宽表,所以一次配置里能同时要榜单和评论,出来按「行类型」筛即可。

宽表的好处是能在同一份数据里横向对照,代价是每条行只有本类型该有的列,其余为空——不是抓漏。「节目行」有名称、发布者、简介、RSS 地址、集数与分类;「榜单行」在节目行基础上多出名次与榜单名称;「单集行」给单集标题、发布时间、时长、音频地址、集号季号与转写稿地址;「评论行」给星级、标题、正文、时间与有用票。

同名列含义随行类型变:「单集标题」在单集行才是单集,评论行用另一列。先按行类型筛再取数。

榜单与评论都分国家,美国区看不到中国区的排名和评论。有两个口径缺口要先知道:节目行的「平均评分」「评论总数」恒为 -1,苹果公开接口不返回,要看评论请用评论采集方式;「上次名次」「名次变化」也恒为 -1、「榜单状态」恒为 new,这两列原本靠跨次运行记历史,本包单次运行给不出。

还有一件事容易踩:发布者邮箱、发布者名称、官网、语言、版权这几列只在节目自己的 RSS 里,苹果接口一个字都不给。所以它们只在读 RSS 的三种方式(查单个节目、列单集、按发布者列节目)有值;搜节目和看榜单不读 RSS,这几列空着不是抓漏——把同批节目换成「查单个节目」再跑一遍就能补上。

还有三种采集没做:单集热榜、付费订阅网络、节目内热门单集,外加一批付费与格式字段——都依赖苹果需要授权令牌的接口(无令牌直接 401),本包不绕过。

结果长什么样

一条单集行是这样的:

单集标题所属节目名发布时间时长(秒)单集类型
The Daily: Monday, Nov 17The Daily2026-11-17T11:00:00Z2146full

一条评论行是这样的:

评论星级评论标题评论者昵称评论时间(原始)有用票净值
1Ads everywherepodcastfan_20242026-11-16T08:41:12Z12

节目行、榜单行则是「节目 ID、节目名称、发布者、分类、集数、RSS 地址」这类列,加上榜单行独有的名次与榜单名称。

应用场景

看某个分类或国家的播客格局,走榜单方式:取前 50 名,对比「集数」「最近一集时间」「是否还在更新」,能看出头部是真在更新还是靠老本吃饭。

做投放或合作评估,走节目方式:发布者邮箱、官网、更新频率、语言和分类都在节目行里,判断一个节目值不值得投,这几列比单看热度可靠。

做选题参考,走单集搜索:按关键词搜单集标题,看同一话题在不同节目里怎么被讲;单集行还带节目笔记和集号季号,够拼出内容结构。

听听众反馈,走评论方式:评论行给星级与正文,按国家分开抓能对比同一档节目在不同市场的口碑差;每国最多 500 条,是苹果的保留上限。

适用边界

只采集苹果公开的播客目录、榜单、评论与 feed 信息;不下载音频,不获取付费订阅专属内容,不绕过任何授权接口

  • 适合用于
  • 选播客做广告投放:先看榜单,再看节目详情里的更新频率与联系方式
  • 品牌或话题监测:搜单集标题里提到自家品牌的节目
  • 播客口碑分析:拉某个节目的听众评论做情感分析
  • 建播客数据库:按分类拉榜单、按发布者拉全部节目、按关键词拉单集
  • 不要用于
  • 要节目评分或评论总数(苹果公开接口不提供,本包这两列恒为 -1)
  • 要 Trending Episodes 单集榜、付费订阅网络(channels)、热门单集排行(top-episodes)——这三个要苹果内部授权接口
  • 要听众数、播放量等后台指标

失败处理

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

  1. 1填节目名当 ID 会 0 条:podcastUrl 只认节目链接或数字 ID,名字要先用 search 模式搜出 ID
  2. 2评论为空:该节目在所选国家确实没有评论,或评论已过苹果保留期;换国家或换节目
  3. 3每国评论最多 500 条(10 页 × 50),第 11 页苹果返回 400,不是本包截断
  4. 4榜单最多 200 条(苹果上限),分类填错会退回全部榜单并记日志
  5. 5episodes 模式依赖节目自己的 RSS:部分节目 feed 只留最近几十集,甚至不公开 feed

输入参数

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

  • 采集模式mode选填string(enum)
    决定这次抓什么。原版的 trending-episodes / channels / top-episodes 三个模式依赖苹果内部授权接口(实测 401),本包不做。
    可选值关键词搜节目search单个节目详情podcast听众评论reviews榜单charts节目单集episodes发布者的全部节目artist按关键词搜单集episode-search默认值search
  • 搜索关键词searchTerm选填string
    search 模式搜节目、episode-search 模式搜单集。留空时 search 按 technology、episode-search 按 ai
    默认值
  • 多个关键词searchTerms选填array<string>
    一次跑多个词,结果合并去重。适合一个词搜不全时扩量
    示例[]
  • 节目链接或 IDpodcastUrl选填string
    podcast / reviews 模式必填,artist 模式可当输入。填 Apple Podcasts 节目链接或纯数字 ID。**填节目名不行**(苹果会返回 0 条),名字请先用 search 模式搜出 ID
    默认值示例https://podcasts.apple.com/us/podcast/the-daily/id1200361736
  • 多个节目链接podcastUrls选填array<string>
    一次跑多个节目,会与上面那条合并去重
    示例[]
  • RSS 地址或节目链接rssFeedUrl选填string
    episodes 模式必填。可以直接填 feed 地址,也可以填 Apple 节目链接(本包会自动去查 feed)
    默认值示例https://podcasts.apple.com/us/podcast/the-daily/id1200361736
  • 多个 RSS 地址rssFeedUrls选填array<string>
    一次解析多个 feed
    示例[]
  • 榜单分类genre选填string
    charts 模式用。留空=全部榜单。填苹果的分类数字 ID(1303 喜剧 / 1311 新闻 / 1318 商业),也可以写 comedy、新闻 这类常见叫法,会自动转成 ID;认不出的值会退回全部榜单并在日志提示(苹果对错值不报错,会静默给总榜)
    默认值
  • 发布者 IDartistId选填string
    artist 模式用。填发布者在苹果的 artistId;不填但填了节目链接时,会从该节目反查发布者
    默认值示例121664449
  • 多个发布者 IDartistIds选填array<string>
    一次列出多个发布者名下的节目
    示例[]
  • 评论排序sortBy选填string(enum)
    reviews 模式用。mostrecent 按最新,mosthelpful 按有用票数(苹果对部分节目会退回最新排序)
    可选值最新优先mostrecent有用优先mosthelpful默认值mostrecent
  • 单集排序sortEpisodes选填string(enum)
    episodes 模式用。默认按 feed 给的顺序
    可选值feed 原顺序最新在前newest最早在前oldest默认值
  • 店铺地区country选填string
    两位国家码小写,如 us / gb / cn / jp。评论与榜单是分国家的,换成 cn 才能看到中国区的数据和中文榜
    默认值us示例us
  • 最多输出行数maxResults选填integer
    整次运行的上限,默认 50;填 0 表示不限(内部兜底 2000)。榜单模式苹果上限 200,评论每国上限 500
    范围0–2000默认值50

输出数据

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

  • 行唯一键recordKeystring
    本行的去重键:节目行 show:{ID}:{国家}、单集行 episode:{ID}、评论行 review:{评论ID}:{国家}、榜单行 chart:{国家}:{分类}:{名次}
    示例show:1200361736:us
  • 行类型rowTypestring
    这一行是什么:show 节目 / chart 榜单 / episode 单集 / review 评论。同名列在不同行类型下含义不同,取数前先按它筛选
    示例show
  • 数据来源sourcestring
    这条数据来自哪个苹果接口:itunes(lookup/search)、rss(榜单/评论/节目 feed),带冒号后缀的是该模式的标记
    示例itunes:podcast
  • 节目 IDappleIdstring
    苹果给节目的数字 ID,同一个节目在不同国家是同一个 ID;单集行与评论行也用它关联回节目
    示例1200361736

示例数据

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

output.example
{
  "recordKey": "show:1200361736:us",
  "rowType": "show",
  "source": "itunes:podcast",
  "appleId": "1200361736",
  "name": "The Daily",
  "artist": "The New York Times",
  "description": "This is what the news should sound like…",
  "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/…/600x600bb.jpg",
  "genres": "[\"News\"]",
  "primaryGenre": "News",
  "genreIds": "[]",
  "trackCount": 2775,
  "feedUrl": "https://feeds.simplecast.com/Sl5CSM3S",
  "releaseDate": "2017-01-30T08:00:00Z",
  "country": "US",
  "podcastUrl": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736",
  "rating": -1,
  "reviewCount": -1,
  "ownerEmail": "thedaily@nytimes.com",
  "ownerName": "The New York Times",
  "websiteUrl": "https://www.nytimes.com/the-daily",
  "language": "en",
  "languageTag": "en",
  "copyright": "© 2026 The New York Times Company",
  "lastEpisodeDate": "2026-11-16T10:45:00Z",
  "episodeFrequency": "weekly",
  "isActive": true,
  "contentRating": "Clean",
  "publisherArtistId": "121664449",
  "rank": 1,
  "chartName": "Top Shows",
  "chartGenre": "News",
  "priorRank": -1,
  "rankChange": -1,
  "status": "new",
  "podcastName": "The Daily",
  "title": "Finally, a Vaccine for Cancer",
  "showNotesHtml": "<p>An experimental vaccine…</p>",
  "pubDate": "2026-11-16T10:45:00Z",
  "pubDateIso": "2026-11-16T10:45:00Z",
  "duration": "00:22:38",
  "durationSeconds": 1358,
  "durationInMilliseconds": 1358000,
  "audioUrl": "https://dts.podtrac.com/redirect.mp3/…/default.mp3",
  "assetUrl": "https://…/default.mp3",
  "audioFileSize": 29992916,
  "audioMimeType": "audio/mpeg",
  "audioExtension": "mp3",
  "imageUrl": "https://is1-ssl.mzstatic.com/…/600x600bb.jpg",
  "episodeType": "full",
  "explicit": false,
  "contentAdvisory": "Clean",
  "guid": "abc-guid-123",
  "episodeNumber": 1237,
  "seasonNumber": 3,
  "episodeId": "1000802251165",
  "episodeUrl": "https://podcasts.apple.com/us/podcast/x/id1200361736?i=1000802251165",
  "keywords": "[\"news\",\"daily\"]",
  "transcriptUrl": "https://example.com/ep1.vtt",
  "offers": "<offers>",
  "subscribable": false,
  "reviewId": "14787667270",
  "reviewAuthor": "bdjohnson724",
  "reviewerUrl": "https://itunes.apple.com/us/reviews/id224929449",
  "reviewRating": 1,
  "reviewTitle": "Fire Barbaro!",
  "reviewContent": "He's just the worst…",
  "reviewDate": "2026-11-13T18:10:21-07:00",
  "reviewDateIso": "2026-11-13T18:10:21-07:00",
  "reviewVoteSum": 0,
  "reviewVoteCount": 0
}

调用方式

本 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-podcasts",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

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

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

价格

按条计费

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

¥0.021/ 条

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

立即体验

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

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