# Apple Podcast Charts & Metadata (`xtracto/apple-podcast-charts`) Actor Pull ranked Apple Podcast charts (with rank for daily velocity), podcast/episode metadata, and search results via Apple's open no-auth iTunes/RSS APIs. Charts, lookup and search modes. Public data, no login. - **URL**: https://apify.com/xtracto/apple-podcast-charts.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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):** ```json { "mode": "charts", "countries": ["us"], "chartLimit": 100 } ```` **Lookup mode (with episodes):** ```json { "mode": "lookup", "podcastIds": ["1200361736"], "includeEpisodes": true, "episodeLimit": 50 } ``` **Search mode:** ```json { "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` ```json { "_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 ```json { "_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` ```json { "_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. # Actor input Schema ## `mode` (type: `string`): What to pull: 'charts' = top-N ranked podcasts per country (each row carries its rank for daily velocity tracking); 'lookup' = podcast metadata (and optionally episodes) by iTunes collection id; 'search' = podcast search results by term. ## `countries` (type: `array`): ISO-2 country/storefront codes to pull top charts for, e.g. us, gb, id, de. One chart per country. Used only in 'charts' mode. ## `chartLimit` (type: `integer`): How many ranked podcasts to pull per country (1-200). Apple caps the feed at 200. Used only in 'charts' mode. ## `podcastIds` (type: `array`): iTunes collection IDs to look up, e.g. 1200361736 (The Daily). Used only in 'lookup' mode. ## `includeEpisodes` (type: `boolean`): If true, also fetch and emit each podcast's episodes (up to 'Episode limit'). Used only in 'lookup' mode. ## `episodeLimit` (type: `integer`): Max episodes to fetch per podcast when 'Include episodes' is on (1-200, Apple's cap). Used only in 'lookup' mode. ## `terms` (type: `array`): Free-text search terms; one search per term. Used only in 'search' mode. ## `country` (type: `string`): ISO-2 storefront code for the search, e.g. us, gb, id. Used only in 'search' mode. ## `searchLimit` (type: `integer`): Max results to return per search term (1-200). Used only in 'search' mode. ## `maxItems` (type: `integer`): Global cap on total records pushed across all countries/ids/terms in this run. 0 = no cap. ## `proxyConfiguration` (type: `object`): Optional. Apple's iTunes/RSS APIs are public and un-WAFed, so proxy is not required. A residential proxy can help if you run many countries and hit soft rate limits. ## Actor input object example ```json { "mode": "charts", "countries": [ "us" ], "chartLimit": 100, "podcastIds": [ "1200361736" ], "includeEpisodes": false, "episodeLimit": 50, "terms": [ "true crime" ], "country": "us", "searchLimit": 25, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": false, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "charts", "countries": [ "us" ], "chartLimit": 100, "podcastIds": [ "1200361736" ], "terms": [ "true crime" ], "country": "us" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/apple-podcast-charts").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "charts", "countries": ["us"], "chartLimit": 100, "podcastIds": ["1200361736"], "terms": ["true crime"], "country": "us", } # Run the Actor and wait for it to finish run = client.actor("xtracto/apple-podcast-charts").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "charts", "countries": [ "us" ], "chartLimit": 100, "podcastIds": [ "1200361736" ], "terms": [ "true crime" ], "country": "us" }' | apify call xtracto/apple-podcast-charts --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/apple-podcast-charts", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Apple Podcast Charts & Metadata", "description": "Pull ranked Apple Podcast charts (with rank for daily velocity), podcast/episode metadata, and search results via Apple's open no-auth iTunes/RSS APIs. Charts, lookup and search modes. Public data, no login.", "version": "0.1", "x-build-id": "Q7rnykhxCzyJqkgAt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~apple-podcast-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-apple-podcast-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/xtracto~apple-podcast-charts/runs": { "post": { "operationId": "runs-sync-xtracto-apple-podcast-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/xtracto~apple-podcast-charts/run-sync": { "post": { "operationId": "run-sync-xtracto-apple-podcast-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "charts", "lookup", "search" ], "type": "string", "description": "What to pull: 'charts' = top-N ranked podcasts per country (each row carries its rank for daily velocity tracking); 'lookup' = podcast metadata (and optionally episodes) by iTunes collection id; 'search' = podcast search results by term.", "default": "charts" }, "countries": { "title": "Countries (charts mode)", "type": "array", "description": "ISO-2 country/storefront codes to pull top charts for, e.g. us, gb, id, de. One chart per country. Used only in 'charts' mode.", "default": [ "us" ], "items": { "type": "string" } }, "chartLimit": { "title": "Chart size (charts mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many ranked podcasts to pull per country (1-200). Apple caps the feed at 200. Used only in 'charts' mode.", "default": 100 }, "podcastIds": { "title": "Podcast IDs (lookup mode)", "type": "array", "description": "iTunes collection IDs to look up, e.g. 1200361736 (The Daily). Used only in 'lookup' mode.", "items": { "type": "string" } }, "includeEpisodes": { "title": "Include episodes (lookup mode)", "type": "boolean", "description": "If true, also fetch and emit each podcast's episodes (up to 'Episode limit'). Used only in 'lookup' mode.", "default": false }, "episodeLimit": { "title": "Episode limit (lookup mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Max episodes to fetch per podcast when 'Include episodes' is on (1-200, Apple's cap). Used only in 'lookup' mode.", "default": 50 }, "terms": { "title": "Search terms (search mode)", "type": "array", "description": "Free-text search terms; one search per term. Used only in 'search' mode.", "items": { "type": "string" } }, "country": { "title": "Search country (search mode)", "type": "string", "description": "ISO-2 storefront code for the search, e.g. us, gb, id. Used only in 'search' mode.", "default": "us" }, "searchLimit": { "title": "Search results per term (search mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Max results to return per search term (1-200). Used only in 'search' mode.", "default": 25 }, "maxItems": { "title": "Max records (0 = no cap)", "minimum": 0, "type": "integer", "description": "Global cap on total records pushed across all countries/ids/terms in this run. 0 = no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Apple's iTunes/RSS APIs are public and un-WAFed, so proxy is not required. A residential proxy can help if you run many countries and hit soft rate limits.", "default": { "useApifyProxy": false, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```