Apple Podcasts Search, Charts and Episodes

Search Apple Podcasts, export country charts, look up podcast metadata, and collect recent episodes with descriptions and audio links. It does not download audio, collect reviews or ratings, or recover a complete episode archive.

One Actor, four modes, one clean table: find podcasts by keyword, pull the Top Shows chart for any Apple storefront country, look up podcasts by Apple ID or link (title, author, genres, artwork, feed URL, episode count, last release), or list each podcast's recent episodes with date, duration, plain-text description and direct audio link. Built for podcast marketers, guest-booking and PR teams, ad buyers and researchers who track the podcast market.

What sets it apart

• $1.40 per 1,000 rows, plus $0.005 per run, in every mode.
• Charts by country: the Top Shows chart (up to 100) for the storefront you pick, with rank, genres and artwork.
• Episodes with audio links: up to 200 recent episodes per podcast, durations in seconds and descriptions as plain text.
• Optional publisher contact, only when you ask for it: the owner name and email the publisher put in their own podcast feed, never guessed.
• Clear partial results: each podcast is saved as soon as it is read, and podcasts that could not be read are named in the run status.

Use cases

• Chart tracking: snapshot the Top Shows chart in several countries every day and follow rank changes.
• Podcast discovery and outreach lists: search a topic, then look up the shows to get feed URLs and, if you choose, the publisher contact from the feed.
• Content monitoring: collect new episodes from a watchlist of podcasts on a schedule.
• Market research: compare genres, episode counts and release activity across a niche.
• Audio and transcript pipelines: feed the episode audio links into your own transcription or analysis.

Quick start

Press Start with the prefilled form: it searches the US storefront for science and returns 10 podcasts (about $0.019). An empty input {} runs the same search as a sample, and the status message says so. A search phrase left empty on purpose ({"searchTerm": ""}) stops at once with a message asking for one.

{"mode": "search", "searchTerm": "science", "country": "us", "maxResults": 10}

Country chart:

{"mode": "charts", "country": "gb", "maxResults": 100}

Recent episodes for podcasts given by Apple ID or link:

{"mode": "episodes", "podcasts": ["979020229", "https://podcasts.apple.com/us/podcast/the-daily/id1200361736"], "country": "us", "maxEpisodesPerPodcast": 10}

Input

Name	Type	Default	What it does
mode	string	from the input	search, charts (country Top Shows), details (podcast metadata) or episodes (recent episodes). Left out, it is details when podcasts are given and search otherwise.
searchTerm	string	none	Search phrase; search mode only.
country	string	us	Two-letter Apple storefront country code (us, gb, de, jp, ...).
maxResults	integer	10	Search or chart rows: up to 200 for search, 100 for charts.
genreId	string	none	Optional numeric Apple genre ID; search mode only. It filters the returned results, so it can give fewer rows.
podcasts	array	none	Apple podcast IDs or podcasts.apple.com links, up to 100. Required for details and episodes, and not accepted in search or charts.
maxEpisodesPerPodcast	integer	10	Recent episodes per podcast, 1 to 200; Apple may return fewer.
includeOwnerContact	boolean	false	Details mode only: add an owner row with the owner name and email the publisher lists in the podcast's public feed.

Output

Every row has rowType, podcastId and a canonical Apple Podcasts url:

• podcast (search and details): title, author, genres, artworkUrl, feedUrl, episodeCount, lastRelease.
• chart: title, author, artworkUrl, genres, country and rank.
• episode: episodeId, title, date, durationSeconds, plain-text description, audioUrl and episodeUrl.
• owner (details mode with includeOwnerContact): ownerName and ownerEmail.

Missing source fields are null. episodeCount is Apple's count for the show and can be larger than the number of episodes Apple makes available.

Output example

A podcast row from a recorded US search for "science" (example values):

{"rowType":"podcast","podcastId":385427377,"url":"https://podcasts.apple.com/us/podcast/id385427377","title":"The Science of Everything Podcast","author":"James Fodor","genres":["Natural Sciences","Podcasts","Science","Social Sciences"],"artworkUrl":"https://is1-ssl.mzstatic.com/image/thumb/Podcasts115/v4/d3/39/01/d33901e5-1b3b-70df-1919-7b0c69d0ab5a/mza_2129224243813628994.jpg/600x600bb.jpg","feedUrl":"https://www.thescienceofeverything.net/feed.xml","episodeCount":172,"lastRelease":"2026-08-30T00:31:00+00:00"}

An episode row (recorded values; description trimmed here):

{"rowType":"episode","podcastId":979020229,"episodeId":1000798431669,"url":"https://podcasts.apple.com/us/podcast/id979020229?i=1000798431669","title":"Personal AI Agents for Pythonistas","date":"2026-10-27T22:27:47+00:00","durationSeconds":3998,"description":"The most popular Python project you've probably never heard of has 252,000 GitHub stars...","audioUrl":"https://talkpython.fm/episodes/download/567/personal-ai-agents-for-pythonistas.mp3?v=2","episodeUrl":"https://podcasts.apple.com/us/podcast/personal-ai-agents-for-pythonistas/id979020229?i=1000798431669&uo=4"}

The status message reports how many rows were saved and names any podcast that could not be read (for example 123: not found).

Pricing

Pay per result:

• $0.005 per Actor start (one start event per GB of memory; the default 512 MB run is one start event, charged even when nothing is found).
• $0.0014 per saved row (podcast, chart, episode or owner row).

Worked costs: the 10-podcast default search is about $0.019; a 100-show country chart about $0.145; 10 recent episodes for each of 20 podcasts (200 rows) about $0.285; 1,000 rows about $1.405.

Scheduling

Schedule charts daily per country to build a rank history, or schedule episodes mode for a list of shows and keep the episodeId values you have not seen before. Each run is a full snapshot; there is no built-in "new episodes only" mode.

FAQ

How fresh is the data? Every run reads Apple Podcasts at run time; nothing is cached between runs.

Can I get every episode of a podcast? No. Apple makes a recent window available (up to 200 episodes); older episodes are not recovered.

Can I get more than 200 search results? No. Search returns at most 200 podcasts with no further pages; use several narrower search terms.

Are genre charts supported? Not yet; charts are the overall Top Shows chart per country.

How long does a run take? Each podcast in details or episodes mode takes a few seconds (about twice as long with owner contact). The default timeout is 5 minutes, which fits roughly 80 podcasts; raise the run timeout for longer lists. A run that reaches its timeout keeps the rows already saved and names the podcasts it did not reach.

Which export formats are available? JSON, CSV, Excel, XML or RSS from the dataset, or read the rows with the Apify API.

Limits

• No audio downloads, ratings, reviews or full episode archives.
• Search: at most 200 results; charts: at most 100; episodes: at most 200 per podcast; up to 100 podcasts per run.
• Availability varies by storefront country.
• Owner contact is only what the publisher put in their own feed; some feeds have none or cannot be read, and those podcasts are named in the run status.
• A run where nothing could be read fails with the reason; a search that simply matches nothing succeeds with no rows.

Support

For help, use the Issues tab on the Actor page and include the run ID.