Apple Podcast Charts & Metadata

Pull ranked Apple Podcast charts, full show and episode metadata, and podcast search results — straight from Apple's public podcast data. Every chart row carries its rank, so snapshotting daily lets you track chart momentum: who is climbing and who is falling.

Why use this actor

• No account, no API key, no login — just press Run.
• Daily chart rankings for any country storefront (US, GB, DE, ID, and more), up to the top 200 shows.
• Track momentum over time — each chart row includes its rank and the chart's timestamp, so running daily and comparing gives you velocity (rising / falling shows).
• Full show and episode metadata — title, publisher, genres, artwork, feed URL, episode titles, descriptions, release dates, and audio links.
• Search any term (e.g. "true crime") and get the matching shows in ranked order.
• Clean, stable JSON ready for spreadsheets, dashboards, databases, or content-trend analytics. Export to JSON, CSV, or Excel, and run it on a schedule.

How it works

1. Pick a mode: charts (top ranked shows per country), lookup (metadata for specific shows, optionally with episodes), or search (shows matching a term).
2. Fill in the countries, show IDs, or search terms (or use the prefilled examples).
3. Press Run. Results stream into the dataset and can be exported to JSON, CSV, or Excel.

No scrapers, servers, or blocks to manage — the actor handles retries for you.

Modes

Mode	What it returns	Key input
charts (default)	Top-ranked shows per country, each with its rank.	countries, chartLimit
lookup	Metadata for specific shows, optionally with their episodes.	podcastIds, includeEpisodes
search	Shows matching a search term, in ranked order.	terms, country

Input

Charts mode (default):

{
  "mode": "charts",
  "countries": ["us"],
  "chartLimit": 100
}

Lookup mode (with episodes):

{
  "mode": "lookup",
  "podcastIds": ["1200361736"],
  "includeEpisodes": true,
  "episodeLimit": 50
}

Search mode:

{
  "mode": "search",
  "terms": ["true crime"],
  "country": "us",
  "searchLimit": 25
}

Field	Type	Description
mode	string	charts, lookup, or search.
countries	array of strings	Charts mode: ISO-2 storefront codes (e.g. us, gb, de), one chart per country.
chartLimit	integer	Charts mode: how many ranked shows per country (1–200).
podcastIds	array of strings	Lookup mode: Apple show IDs (e.g. 1200361736 = The Daily).
includeEpisodes	boolean	Lookup mode: also return each show's episodes.
episodeLimit	integer	Lookup mode: max episodes per show (1–200).
terms	array of strings	Search mode: free-text search terms, one search each.
country	string	Search mode: storefront code for the search (e.g. us).
searchLimit	integer	Search mode: max results per term (1–200).
maxItems	integer	Global cap on total records (0 = no cap).
proxyConfiguration	object	Optional. Not required — the data is public.

Output

Every record carries a small header (_input, _scrapedAt, _source, recordType) plus the show/episode data with Apple's original field names preserved. recordType is CHART_ENTRY, PODCAST, EPISODE, or SEARCH_RESULT. Chart and search records also include rank.

CHART_ENTRY — mode charts, country us

{
  "_input": "charts:us:top100",
  "_scrapedAt": "2026-07-09T11:08:16Z",
  "_source": "S1-charts",
  "recordType": "CHART_ENTRY",
  "rank": 1,
  "chartCountry": "us",
  "chartTitle": "Top Shows",
  "chartUpdated": "Thu, 9 Jul 2026 11:08:16 +0000",
  "artistName": "The New York Times",
  "id": "1200361736",
  "name": "The Daily",
  "kind": "podcasts",
  "artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/.../100x100bb.png",
  "genres": [{ "genreId": "1489", "name": "News", "url": "https://itunes.apple.com/us/genre/id1489" }],
  "url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736"
}

EPISODE — mode lookup, show 1200361736, includeEpisodes on

{
  "_input": "lookup:1200361736:episodes",
  "_scrapedAt": "2026-07-09T15:49:36Z",
  "_source": "S1-lookup",
  "recordType": "EPISODE",
  "wrapperType": "podcastEpisode",
  "kind": "podcast-episode",
  "collectionId": 1200361736,
  "collectionName": "The Daily",
  "trackId": 1000776099808,
  "trackName": "The Unprecedented Personal Profits of Trump's Presidency",
  "releaseDate": "2026-07-09T09:47:59Z",
  "episodeGuid": "955986ad-c79e-4bcc-8536-3a7280540ab0",
  "feedUrl": "https://feeds.simplecast.com/Sl5CSM3S",
  "trackTimeMillis": 1796000,
  "episodeUrl": "https://.../default.mp3",
  "trackViewUrl": "https://podcasts.apple.com/us/podcast/.../id1200361736?i=1000776099808&uo=4",
  "description": "A recent financial disclosure shows that President Trump has made $2.2 billion since he returned to office. Today, Eric Lipton, a New York Times investigative reporter, reveals the Trump family's n...",
  "genres": [{ "name": "Daily News", "id": "1526" }]
}

SEARCH_RESULT — mode search, term true crime

{
  "_input": "search:true crime:us",
  "_scrapedAt": "2026-07-09T15:49:37Z",
  "_source": "S1-search",
  "recordType": "SEARCH_RESULT",
  "rank": 1,
  "kind": "podcast",
  "artistName": "Audiochuck",
  "collectionId": 1322200189,
  "collectionName": "Crime Junkie",
  "trackName": "Crime Junkie",
  "feedUrl": "https://feeds.simplecast.com/qm_9xx0g",
  "collectionViewUrl": "https://podcasts.apple.com/us/podcast/crime-junkie/id1322200189?uo=4",
  "releaseDate": "2026-07-06T07:00:00Z",
  "trackCount": 517,
  "primaryGenreName": "True Crime",
  "genres": ["True Crime", "Podcasts"]
}

Key output fields

Field	Type	Description
recordType	string	CHART_ENTRY, PODCAST, EPISODE, or SEARCH_RESULT.
rank	integer	Chart / search position (1 = top). Use across daily runs to compute momentum.
chartCountry / chartTitle / chartUpdated	string	Country, chart name, and timestamp (chart records).
id / collectionId	string / number	Apple show ID.
name / collectionName	string	Show title.
artistName	string	Publisher / creator.
trackName	string	Episode title (episode records).
releaseDate	string	Publish date.
feedUrl	string	The show's RSS feed.
trackCount	number	Number of episodes in the show.
primaryGenreName / genres	string / array	Category information.
description	string	Episode summary (episode records).
episodeUrl / previewUrl	string	Audio links (episode records).
artworkUrl100 / artworkUrl600	string	Cover artwork.

On any failure the actor emits a {_input, _scrapedAt, _source, _error, _errorDetail} record instead of silently skipping.

Tracking chart momentum

1. Run this actor in charts mode on a daily schedule (same countries and chart size).
2. Key each show by its id and store its rank and _scrapedAt.
3. Compare today's rank to yesterday's: a smaller rank means the show is climbing. New shows have no prior rank; shows that leave the chart simply disappear from the feed.

Notes & limits

• Charts are capped at 200 shows per country by Apple.
• Episode listings are capped at 200 episodes per show.
• All data is public — no account or key needed. A proxy is optional and only helps if you pull many countries at once.