# Apple Podcast Episodes Scraper (`codingfrontend/apple-podcast-episodes-scraper`) Actor

Extracts public Apple Podcast episode metadata and audio URLs from a podcast ID using Apple's public lookup endpoint and the publisher's RSS feed.

- **URL**: https://apify.com/codingfrontend/apple-podcast-episodes-scraper.md
- **Developed by:** [Coding Frontned](https://apify.com/codingfrontend) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What this Actor does

Collect episode information from public [Apple Podcasts](https://podcasts.apple.com/) listings and each publisher's public RSS feed. Results include complete available episode descriptions, publication dates, audio links and media details, artwork, podcast categories, publisher contacts, Apple catalogue information, ratings and channel details.

Use the results for podcast catalogues, release tracking, listening lists and research. Audio files are linked, rather than downloaded. The Actor can read a published transcript from a matching public NPR episode page when the publisher permits access; it does not generate transcripts or access subscription audio.

### How to run it

1. Open the **Input** tab. The default podcast is **Planet Money**.
2. To choose other shows, put their Apple Podcasts IDs or public show URLs in **Podcast IDs or Apple Podcasts URLs**.
3. Choose **Maximum episodes per podcast**. The default is 100.
4. Start the run, then open **Episodes** in **Output** to view or download the results.
5. Open **Output summary** to see the saved-record count and whether collection was partial.

The Actor reads the complete public feed, then selects episodes in feed order. The limit applies separately to each podcast. Duplicate podcast IDs and episode GUIDs are removed. Apple may display more episodes than the public feed provides, including subscription-only or archived episodes.

### Input options

All settings are optional because a default show is provided. If you supply `podcastIds`, provide 1–20 non-empty strings containing IDs or public HTTPS Apple show URLs. Use this one selection field; old singular-ID and URL aliases are no longer accepted. Numeric JSON values and unsupported input fields are rejected.

| Field | Type | Required? | Default | What it does |
| --- | --- | --- | --- | --- |
| `podcastIds` | Array of strings | Optional | `["290783428"]` | One to 20 Apple Podcasts collection IDs (3–20 digits) or public HTTPS show URLs on podcasts.apple.com or itunes.apple.com. URLs must use a /podcast/.../id<digits> path. Defaults to Planet Money (290783428). |
| `maxEpisodes` | Integer | Optional | `100` | Maximum number of RSS episodes saved for each podcast; this limit is applied after the publisher feed is read. Range: 1–500. |
| `timeoutSecs` | Integer | Optional | `30` | Maximum time allowed for each request, including its robots.txt check and redirect chain. Range: 5–120. |
| `maxResponseBytes` | Integer | Optional | `10000000` | Fail closed when a public lookup, RSS, or enrichment response exceeds this byte limit. The default accommodates the verified Planet Money feed. Range: 10000–15000000. |
| `requestDelayMs` | Integer | Optional | `250` | Delay between requests to the same source origin. Apple lookup has a 3.1-second minimum, and longer published crawl-delay values are honored; setting this to 0 does not disable those limits. Range: 0–5000. |
| `proxyConfiguration` | Object | Optional | `{"useApifyProxy":false}` | Native Apify proxy settings. Proxy use is off by default. |

#### Copyable input examples

A small Planet Money run:

```json
{
  "podcastIds": [
    "290783428"
  ],
  "maxEpisodes": 2
}
```

Use a public Apple show URL:

```json
{
  "podcastIds": [
    "https://podcasts.apple.com/us/podcast/planet-money/id290783428"
  ],
  "maxEpisodes": 2
}
```

Collect from two shows:

```json
{
  "podcastIds": [
    "290783428",
    "121493675"
  ],
  "maxEpisodes": 1
}
```

Adjust request settings and choose an optional proxy:

```json
{
  "podcastIds": [
    "290783428"
  ],
  "maxEpisodes": 2,
  "timeoutSecs": 30,
  "maxResponseBytes": 10000000,
  "requestDelayMs": 500,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

#### Developer options

Request limits and proxy settings are intended for advanced use. Proxy use is off by default. The native proxy editor supports your available Apify groups/country or custom HTTP, HTTPS and SOCKS5 proxy URLs; these choices are mutually exclusive. A configured route is used consistently, with no silent switch to direct access. Proxy access and bandwidth may incur charges.

The response-size limit applies to the complete feed and to each enrichment response. Lowering the episode limit does not shrink an RSS feed. The default response cap is 10 MB and the maximum is 15 MB; oversized responses are rejected without publishing truncated XML. Requests share a bounded run budget of 150 seconds, with time reserved to save known episodes and the summary. Longer requests cannot extend that budget. The Actor respects published crawl delays and Apple's lookup pacing even when the additional delay is zero.

### Episode dataset

Each dataset item represents one real episode. Fields that the source does not supply are omitted; the Actor does not fill them with sample values or empty placeholders. RSS descriptions retain their full available text. HTML descriptions are source content and should be sanitized before displaying them on a website.

#### Example output record

This is one complete record saved by a live NPR News Now run. It includes every field returned for that episode; other episodes can have different optional fields. Dates, ratings, available episodes and URLs can change.

```json
{
  "podcastId": "121493675",
  "podcastTitle": "NPR News Now",
  "publisher": "NPR",
  "episodeTitle": "11pm ET, October 13 | The latest headlines from NPR",
  "episodeDescription": "The latest headlines from NPR at the top of this hour.\n\nThe stories you hear are written, reported and fact-checked by NPR journalists. Learn more about the standards of our journalism at npr.org/ethics.\n\nSupport public media with NPR+ and enjoy perks for over 25 podcasts like this one. This show’s perks include sponsor-free listening. Learn more at plus.npr.org.\n\nSee pcm.adswizz.com for information about our collection and use of personal data for sponsorship and to manage your podcast sponsorship preferences.\n\nNPR Privacy Policy",
  "audioUrl": "https://prfx.byspotify.com/e/play.podtrac.com/npr-500005/npr.simplecastaudio.com/368f8510-314e-46f1-8d26-5b87ed6ab6eb/episodes/6ed1e7be-0116-48c9-896a-bdf5345d878a/audio/128/default.mp3?awCollectionId=368f8510-314e-46f1-8d26-5b87ed6ab6eb&awEpisodeId=6ed1e7be-0116-48c9-896a-bdf5345d878a&feed=O9WlY7a5&t=podcast&e=nx-s1-20261013-2300-long&p=500005&d=280&size=4585474",
  "publishedAt": "2026-10-14T03:10:07.000Z",
  "durationSeconds": 280,
  "episodeType": "full",
  "imageUrl": "https://media.npr.org/assets/img/2023/01/24/npr-news-now_tile_sq-2334a5fd44563fa94cdcdb27384b0f05987c2d15.jpg?s=1400&c=66&f=jpg",
  "guid": "23aed9a5-6398-411b-9f88-3a0784432ce3",
  "episodeDescriptionHtml": "The latest headlines from NPR at the top of this hour. <br/><br/>The stories you hear are written, reported and fact-checked by NPR journalists.  Learn more about the standards of our journalism at<a href=\"http://npr.org/ethics\"target=\"_blank\"   > npr.org/ethics</a>. <br/><br/>Support public media with NPR+ and enjoy perks for over 25 podcasts like this one. This show’s perks include sponsor-free listening. Learn more at <a href=\"http://plus.npr.org/\"target=\"_blank\"   >plus.npr.org</a>.<br/><br/>See <a href=\"https://pcm.adswizz.com\">pcm.adswizz.com</a> for information about our collection and use of personal data for sponsorship and to manage your podcast sponsorship preferences.<br/><br/><a href=\"https://www.npr.org/about-npr/179878450/privacy-policy\">NPR Privacy Policy</a>",
  "isExplicit": false,
  "audio": {
    "mimeType": "audio/mpeg",
    "byteLength": 4585474
  },
  "links": [
    {
      "url": "http://npr.org/ethics",
      "label": "npr.org/ethics"
    },
    {
      "url": "http://plus.npr.org/",
      "label": "plus.npr.org"
    },
    {
      "url": "https://pcm.adswizz.com/",
      "label": "pcm.adswizz.com"
    },
    {
      "url": "https://www.npr.org/about-npr/179878450/privacy-policy",
      "label": "NPR Privacy Policy"
    }
  ],
  "podcast": {
    "description": "The latest news in five minutes. Updated hourly.\n\nSupport public media by joining NPR+ at plus.npr.org. You’ll get perks for over 25 NPR podcasts, including sponsor-free listening for NPR News Now, UP First, and more.",
    "descriptionHtml": "The latest news in five minutes. Updated hourly. <br><br><em>Support public media by joining NPR+ at </em><a href=\"http://plus.npr.org/\"target=\"_blank\"   ><em>plus.npr.org</em></a><em>. You’ll get perks for over 25 NPR podcasts, including sponsor-free listening for NPR News Now, UP First, and more.</em>",
    "websiteUrl": "https://www.npr.org/podcasts/500005/npr-news-now",
    "feedUrl": "https://feeds.npr.org/500005/podcast.xml",
    "appleUrl": "https://podcasts.apple.com/us/podcast/npr-news-now/id121493675?uo=4",
    "language": "en-us",
    "copyright": "Copyright 2007-2026 NPR - For Personal Use Only",
    "type": "episodic",
    "isExplicit": false,
    "categories": [
      {
        "name": "News",
        "id": "1489"
      },
      {
        "name": "Daily News",
        "id": "1526"
      }
    ],
    "owner": {
      "name": "NPR",
      "email": "podcasts@npr.org"
    },
    "appleArtistUrl": "https://podcasts.apple.com/us/artist/npr/125443881?uo=4",
    "appleArtistId": "125443881",
    "appleCatalog": {
      "genres": [
        {
          "name": "Daily News",
          "id": "1526"
        },
        {
          "name": "Podcasts",
          "id": "26"
        },
        {
          "name": "News",
          "id": "1489"
        }
      ],
      "primaryGenreName": "Daily News",
      "trackCount": 4,
      "releaseDate": "2026-10-14T02:09:00.000Z",
      "country": "USA",
      "currency": "USD",
      "collectionPrice": 0,
      "trackPrice": 0,
      "collectionExplicitness": "notExplicit",
      "trackExplicitness": "notExplicit",
      "artwork": {
        "url30": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/27/a0/ab/27a0abb7-817f-d80c-4fed-6fd04d424333/mza_16804553558295235422.jpg/30x30bb.jpg",
        "url60": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/27/a0/ab/27a0abb7-817f-d80c-4fed-6fd04d424333/mza_16804553558295235422.jpg/60x60bb.jpg",
        "url100": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/27/a0/ab/27a0abb7-817f-d80c-4fed-6fd04d424333/mza_16804553558295235422.jpg/100x100bb.jpg",
        "url600": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/27/a0/ab/27a0abb7-817f-d80c-4fed-6fd04d424333/mza_16804553558295235422.jpg/600x600bb.jpg"
      }
    },
    "images": [
      {
        "url": "https://media.npr.org/assets/img/2023/01/24/npr-news-now_tile_wide-cd662e8ee0b78577e2f736b32e9663d4a3ac297b.jpg?s=2858&c=66&f=jpg",
        "width": 2858,
        "height": 1608
      },
      {
        "url": "https://media.npr.org/assets/img/2023/01/24/npr-news-now_tile_sq-2334a5fd44563fa94cdcdb27384b0f05987c2d15.jpg?s=1400&c=66&f=jpg"
      }
    ],
    "funding": [
      {
        "url": "https://plus.npr.org/?utm_source=podcast_rss_funding_tag",
        "label": "Support NPR by enrolling in NPR+!"
      }
    ],
    "mediaRestriction": {
      "type": "country",
      "relationship": "allow",
      "value": "ad ar at au be bg bo br ca ch cl co cr cy cz de dk do ec ee es fi fr gb gr gt hn hu id ie il is it jp li lt lu lv mc mt mx my ni nl no nz pa pe pl pt py ro se sk sv th us uy za"
    },
    "rating": {
      "value": 4.2,
      "count": 14377
    },
    "episodeCount": 4,
    "yearsActive": "2006 - 2026",
    "updateFrequency": "Updated Daily",
    "provider": "NPR",
    "channel": {
      "id": "6769050772",
      "name": "NPR Podcasts",
      "url": "https://podcasts.apple.com/us/channel/npr-podcasts/id6769050772",
      "description": "Step into the universe of NPR Podcasts. It’s a place where curiosity leads, stories unfold, and every voice deserves a mic. From deep-dives that reshape how you see the world, to intimate conversations that feel like they’re meant just for you, we’ve got a show for whatever you’re looking for (and shows that you didn't know you needed).  \n\nWant to get clued in to what’s happening today? Start your morning with our news podcasts. Looking to get to know the world around you? You’re in luck. From narrative storytelling, to self-help tips; from history shows, documentary investigations, science features, incredible music, and human interest from every genre - we’re a living, evolving soundscape of ideas and perspectives. Stay here to hear - to listen - because there’s always more to discover.",
      "showCount": 88,
      "image": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/PodcastSource221/v4/b3/57/3e/b3573ee5-c054-d84f-c7ab-5893159f2711/f6851eda-e554-4c08-a556-35d860444e76.png/800x200bb.webp",
        "mimeType": "image/webp",
        "originalWidth": 3000,
        "originalHeight": 750
      }
    }
  }
}
```

#### Output fields

`[]` indicates an item inside an array. A nested field marked “Required within parent” is required only when its optional containing object is present.

| Field | Type | Required? | Meaning |
| --- | --- | --- | --- |
| `podcastId` | Text | Required | Numeric Apple Podcasts collection ID used for this feed. |
| `podcastTitle` | Text | Optional | Podcast title from its public RSS channel when available. |
| `publisher` | Text | Optional | Publisher or author name from Apple lookup or the RSS channel when available. |
| `episodeTitle` | Text | Required | Episode title from the RSS item. Every stored record includes this field. |
| `episodeDescription` | Text | Optional | Plain text description from the RSS item when available. |
| `episodeUrl` | URL | Optional | Public episode page link from the RSS item when available. |
| `audioUrl` | URL | Optional | Public audio enclosure URL from the RSS item when available. |
| `publishedAt` | Text | Optional | Episode publication date normalized to ISO 8601 when the RSS date is valid. |
| `durationSeconds` | Integer | Optional | Episode duration converted from the RSS duration when available. |
| `seasonNumber` | Integer | Optional | RSS season number when supplied as a non-negative integer. |
| `episodeNumber` | Integer | Optional | RSS episode number when supplied as a non-negative integer. |
| `episodeType` | Text | Optional | RSS episode type when supplied by the publisher. |
| `imageUrl` | URL | Optional | Episode artwork or podcast artwork URL when available. |
| `guid` | Text | Required | RSS item GUID, or its public episode or audio URL when the publisher omits a GUID. Every stored record includes an identity value. |
| `episodeDescriptionHtml` | Text | Optional | Full episode description markup from RSS, or a verified Apple detail-page fallback. |
| `episodeSummary` | Text | Optional | Separate short RSS summary, when distinct from the full description. |
| `author` | Text | Optional | RSS item author as published. |
| `isExplicit` | Boolean | Optional | Episode explicit-content flag from RSS or a matched Apple episode. |
| `audio` | Object | Optional | Metadata for the enclosure represented by audioUrl; audio is not downloaded. |
| `audio.mimeType` | Text | Optional | Published enclosure MIME type. |
| `audio.byteLength` | Integer | Optional | Published enclosure byte length. |
| `images` | Array of objects | Optional | RSS episode artwork and thumbnails, preserving available dimensions. |
| `images[].url` | URL | Required within parent | Artwork URL. |
| `images[].width` | Integer | Optional | Published image width in pixels. |
| `images[].height` | Integer | Optional | Published image height in pixels. |
| `links` | Array of objects | Optional | All public links in the full episode description, deduplicated by URL and label. |
| `links[].url` | URL | Required within parent | Link destination. |
| `links[].label` | Text | Optional | Source link text. |
| `appleEpisode` | Object | Optional | Apple catalogue identity and access information, joined to this RSS episode by audio URL and verified on its detail page. |
| `appleEpisode.id` | Text | Optional | Native Apple episode ID. |
| `appleEpisode.url` | URL | Optional | Canonical Apple episode URL. |
| `appleEpisode.contentRating` | Text | Optional | Apple content rating, such as clean or explicit. |
| `appleEpisode.access` | Text | Optional | Source entitlement label, such as free. It does not grant subscriber access. |
| `podcast` | Object | Optional | Additional podcast-level business information from RSS, Apple lookup and the public show/channel pages. |
| `podcast.description` | Text | Optional | Complete RSS channel description as plain text. |
| `podcast.descriptionHtml` | Text | Optional | Complete RSS channel description markup, when present. |
| `podcast.websiteUrl` | URL | Optional | Publisher website supplied by the RSS channel. |
| `podcast.feedUrl` | URL | Optional | Public RSS subscription URL. |
| `podcast.appleUrl` | URL | Optional | Apple Podcasts show page. |
| `podcast.language` | Text | Optional | RSS language code. |
| `podcast.copyright` | Text | Optional | RSS copyright notice. |
| `podcast.type` | Text | Optional | RSS or Apple show type, such as episodic or serial. |
| `podcast.isExplicit` | Boolean | Optional | Explicit-content flag published for the show. |
| `podcast.categories` | Array of objects | Optional | All RSS channel categories; Apple genre IDs are matched by name. |
| `podcast.categories[].name` | Text | Required within parent | Category name. |
| `podcast.categories[].id` | Text | Optional | Apple genre ID. |
| `podcast.owner` | Object | Optional | Public RSS business contact. |
| `podcast.owner.name` | Text | Optional | Contact name. |
| `podcast.owner.email` | Text | Optional | Publisher-provided contact email. |
| `podcast.appleArtistUrl` | URL | Optional | Artist profile URL supplied by Apple lookup, which can retain a historical association. |
| `podcast.appleArtistId` | Text | Optional | Native artist ID supplied by Apple lookup, which can retain a historical association. |
| `podcast.appleCatalog` | Object | Optional | Business metadata published in the Apple Podcasts lookup result for this show. |
| `podcast.appleCatalog.genres` | Array of objects | Optional | All genres in Apple lookup order, including genres that are not repeated in the RSS category list. |
| `podcast.appleCatalog.genres[].name` | Text | Required within parent | Genre name from Apple lookup. |
| `podcast.appleCatalog.genres[].id` | Text | Optional | Apple genre ID aligned by source order. |
| `podcast.appleCatalog.primaryGenreName` | Text | Optional | Primary genre name published by Apple lookup. |
| `podcast.appleCatalog.trackCount` | Integer | Optional | Track count reported by Apple lookup; it may differ from a fetched RSS page count. |
| `podcast.appleCatalog.releaseDate` | Text | Optional | Release timestamp reported by Apple lookup. |
| `podcast.appleCatalog.country` | Text | Optional | Country label reported by Apple lookup. |
| `podcast.appleCatalog.currency` | Text | Optional | Currency code reported with Apple lookup prices. |
| `podcast.appleCatalog.collectionPrice` | Number | Optional | Collection price reported by Apple lookup. |
| `podcast.appleCatalog.trackPrice` | Number | Optional | Track price reported by Apple lookup. |
| `podcast.appleCatalog.collectionExplicitness` | Text | Optional | Collection explicitness label from Apple lookup. |
| `podcast.appleCatalog.trackExplicitness` | Text | Optional | Track explicitness label from Apple lookup. |
| `podcast.appleCatalog.contentAdvisoryRating` | Text | Optional | Content advisory rating when Apple lookup supplies one. |
| `podcast.appleCatalog.artwork` | Object | Optional | Artwork URLs supplied verbatim by Apple lookup at the listed sizes. |
| `podcast.appleCatalog.artwork.url30` | URL | Optional | Apple lookup artworkUrl30. |
| `podcast.appleCatalog.artwork.url60` | URL | Optional | Apple lookup artworkUrl60. |
| `podcast.appleCatalog.artwork.url100` | URL | Optional | Apple lookup artworkUrl100. |
| `podcast.appleCatalog.artwork.url600` | URL | Optional | Apple lookup artworkUrl600. |
| `podcast.contributors` | Array of objects | Optional | People listed in the Apple Podcasts Hosts & Guests shelf for this show. |
| `podcast.contributors[].name` | Text | Required within parent | Person name as shown by Apple Podcasts. |
| `podcast.contributors[].role` | Text | Optional | Person role or roles supplied in the Apple shelf subtitle. |
| `podcast.contributors[].id` | Text | Optional | Native Apple contributor ID, when supplied. |
| `podcast.images` | Array of objects | Optional | RSS channel artwork and thumbnails. |
| `podcast.images[].url` | URL | Required within parent | Artwork URL. |
| `podcast.images[].width` | Integer | Optional | Published image width in pixels. |
| `podcast.images[].height` | Integer | Optional | Published image height in pixels. |
| `podcast.funding` | Array of objects | Optional | Publisher-supplied support links. |
| `podcast.funding[].url` | URL | Required within parent | Link destination. |
| `podcast.funding[].label` | Text | Optional | Source link text. |
| `podcast.mediaRestriction` | Object | Optional | Media RSS distribution restriction published for the feed, including its original value. |
| `podcast.mediaRestriction.type` | Text | Optional | Restriction type supplied by the publisher, such as country. |
| `podcast.mediaRestriction.relationship` | Text | Optional | Restriction relationship supplied by the publisher, such as allow or deny. |
| `podcast.mediaRestriction.value` | Text | Optional | Complete source value for the restriction. |
| `podcast.rating` | Object | Optional | Ratings displayed by Apple for the selected storefront. |
| `podcast.rating.value` | Number | Optional | Published average rating out of five. |
| `podcast.rating.count` | Integer | Optional | Number of ratings, not the number of written reviews. |
| `podcast.episodeCount` | Integer | Optional | Apple catalogue episode count; can exceed public RSS availability. |
| `podcast.seasonCount` | Integer | Optional | Season count displayed by Apple. |
| `podcast.yearsActive` | Text | Optional | Years-active text displayed by Apple; not inferred. |
| `podcast.updateFrequency` | Text | Optional | Published update frequency label. |
| `podcast.provider` | Text | Optional | Provider displayed in Apple show information. |
| `podcast.channel` | Object | Optional | Associated Apple Podcasts publisher channel, not a recommended show. |
| `podcast.channel.id` | Text | Optional | Apple channel ID. |
| `podcast.channel.name` | Text | Optional | Channel name. |
| `podcast.channel.url` | URL | Optional | Public channel page. |
| `podcast.channel.description` | Text | Optional | Full channel description. |
| `podcast.channel.showCount` | Integer | Optional | Number of shows displayed on the channel page. |
| `podcast.channel.image` | Object | Optional | Published channel logo rendition with original artwork dimensions. |
| `podcast.channel.image.url` | URL | Required within parent | Explicit logo URL from the public page picture source. |
| `podcast.channel.image.mimeType` | Text | Optional | Published picture source MIME type. |
| `podcast.channel.image.originalWidth` | Integer | Optional | Original artwork width from Apple catalogue metadata; not the rendition width. |
| `podcast.channel.image.originalHeight` | Integer | Optional | Original artwork height from Apple catalogue metadata; not the rendition height. |
| `publisherEpisode` | Object | Optional | Additional episode-page information currently supported for public NPR episode pages. |
| `publisherEpisode.id` | Text | Optional | Native NPR story ID. |
| `publisherEpisode.descriptionText` | Text | Optional | Complete article body, including credits, without navigation or advertising. |
| `publisherEpisode.descriptionHtml` | Text | Optional | Article paragraphs, lists and headings as HTML. |
| `publisherEpisode.authors` | Array of objects | Optional | All linked names in the episode byline, in source order. |
| `publisherEpisode.authors[].name` | Text | Required within parent | Published byline name. |
| `publisherEpisode.authors[].url` | URL | Optional | Contributor profile URL. |
| `publisherEpisode.transcript` | Object | Optional | Full linked public NPR transcript; no transcription is performed. |
| `publisherEpisode.transcript.url` | URL | Optional | Public transcript link. |
| `publisherEpisode.transcript.text` | Text | Optional | Complete published transcript with paragraph breaks and publisher notices. |
| `publisherEpisode.images` | Array of objects | Optional | Episode article images with their published alternative text, credits and original dimensions. |
| `publisherEpisode.images[].url` | URL | Required within parent | Actual article image URL. |
| `publisherEpisode.images[].alt` | Text | Optional | Source image alternative text. |
| `publisherEpisode.images[].credit` | Text | Optional | Published image credit. |
| `publisherEpisode.images[].originalWidth` | Integer | Optional | Original image width supplied by the publisher, not the resized URL width. |
| `publisherEpisode.images[].originalHeight` | Integer | Optional | Original image height supplied by the publisher, not the resized URL height. |

Apple episode enrichment requires matching show identity, RSS GUID and audio URL. Show and channel details are taken from the corresponding public Apple pages, with no joins to recommended shows. The separate `podcast.appleCatalog` values come from Apple's public lookup response; its country and prices describe the catalogue response, and its count can differ from the RSS feed. Artwork URLs and dimensions come from the source, without invented image sizes.

Additional publisher-page details currently support NPR. A matching public article can provide contributors, images and its complete published transcript. If that origin is unavailable or disallows collection, valid RSS and Apple data are retained and the run is marked partial. Other publishers retain their RSS and Apple information without publisher-page extraction. Private feeds, login-only content, subscription streams and Apple in-app transcripts are not collected. No keyword search, custom episode filters, catalogue pagination or audio transcription is offered.

Download results as JSON, CSV, Excel or other formats from the dataset. Structured nested fields are most completely represented in JSON.

### Run status

- **SUCCEEDED** means at least one valid episode was acknowledged by dataset storage. If a later source, enrichment step or write fails, already saved episodes remain and the summary reports partial results.
- **FAILED** means no valid episodes were saved. Inaccessible, empty and invalid sources do not produce diagnostic or dummy dataset rows.
- Reaching the requested episode limit is normal completion. Missing optional source fields alone do not make a run partial.

### Output summary

The **Output summary** link opens `OUTPUT_SUMMARY` in the run's default **Key-value store**. This record is separate from the episode dataset and contains exactly these three fields:

```json
{
  "status": "SUCCEEDED",
  "itemsStored": 2,
  "isPartial": false
}
```

| Field | Type | Required? | Meaning |
| --- | --- | --- | --- |
| `status` | Text | Required | SUCCEEDED when at least one episode was saved; otherwise FAILED. |
| `itemsStored` | Integer | Required | Number of valid episode writes acknowledged by dataset storage. |
| `isPartial` | Boolean | Required | True when source, enrichment, write or runtime interruption affected a run that saved episodes; false when zero episodes were saved. |

### Pricing and access limits

The current Actor price is **$0.00399 per saved episode**, plus a one-time start event of **$0.001 per GB of allocated memory** (minimum one start event). Apify platform usage and optional proxy traffic are additional. Check the live Actor pricing and your spending limit before a large run; pricing can change.

Publishers control feed availability and permitted use. Some feeds exceed 15 MB; these fail without truncated or synthetic records. Publisher enrichment can be unavailable even while the RSS feed works. The Actor keeps the valid results it can obtain and records the limitation in run logs and the summary. A public audio link can contain publisher tracking parameters or expire; it is not a downloaded audio file.

### Support

Use the Actor's **Issues** tab and include the run ID and public podcast URL when reporting a problem. Keep passwords, tokens and private feed URLs out of reports.

This Actor is not affiliated with Apple or NPR. Use public data according to publisher terms and applicable copyright and privacy requirements.

# Actor input Schema

## `podcastIds` (type: `array`):

One to 20 Apple Podcasts collection IDs (3–20 digits) or public HTTPS show URLs on podcasts.apple.com or itunes.apple.com. URLs must use a /podcast/.../id<digits> path. Defaults to Planet Money (290783428).

## `maxEpisodes` (type: `integer`):

Maximum number of RSS episodes saved for each podcast; this limit is applied after the publisher feed is read.

## `timeoutSecs` (type: `integer`):

Maximum time allowed for each request, including its robots.txt check and redirect chain.

## `maxResponseBytes` (type: `integer`):

Fail closed when a public lookup, RSS, or enrichment response exceeds this byte limit. The default accommodates the verified Planet Money feed.

## `requestDelayMs` (type: `integer`):

Delay between requests to the same source origin. Apple lookup has a 3.1-second minimum, and longer published crawl-delay values are honored; setting this to 0 does not disable those limits.

## `proxyConfiguration` (type: `object`):

Native Apify proxy settings. Proxy use is off by default.

## Actor input object example

```json
{
  "podcastIds": [
    "290783428"
  ],
  "maxEpisodes": 100,
  "timeoutSecs": 30,
  "maxResponseBytes": 10000000,
  "requestDelayMs": 250,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing validated public podcast episode records.

## `runSummary` (type: `string`):

Run status and count of episode records successfully saved.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("codingfrontend/apple-podcast-episodes-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "proxyConfiguration": { "useApifyProxy": False } }

# Run the Actor and wait for it to finish
run = client.actor("codingfrontend/apple-podcast-episodes-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call codingfrontend/apple-podcast-episodes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,codingfrontend/apple-podcast-episodes-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/k3Qsll2Z25iIRaHNV/builds/pPBEnDebQcoLi7XVC/openapi.json
