# Podcast RSS Episode Extractor (`s3nafps/podcast-rss-episode-extractor`) Actor Extract clean podcast episode data from public RSS and Atom feeds. Get episode titles, episode URLs, audio URLs, publish dates, durations, descriptions, GUIDs, and show titles as structured JSON or CSV. - **URL**: https://apify.com/s3nafps/podcast-rss-episode-extractor.md - **Developed by:** [mohamed senator](https://apify.com/s3nafps) (community) - **Categories:** News, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.30 / 1,000 extracted episodes This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Podcast RSS Episode Extractor Extract clean podcast episode data from public RSS and Atom feeds. This Apify Actor turns one or more podcast feed URLs into a structured dataset with episode titles, URLs, audio links, publish dates, durations, descriptions, GUIDs, and source feed information. ### What does this Actor do? Podcast RSS Episode Extractor helps researchers, content marketers, podcast agencies, newsletter writers, media monitors, and no-code operators collect podcast episode metadata without building their own feed parser. You provide public podcast RSS or Atom feed URLs. The Actor fetches each feed, parses the XML, normalizes common podcast fields, deduplicates episodes, and saves the results to an Apify Dataset. It uses only public feed URLs that you provide. It does not log in to platforms, bypass CAPTCHA, scrape private content, or generate fake output. ### Typical use cases - Build a podcast episode database from public feeds - Monitor competitor podcast publishing activity - Collect episode URLs and audio URLs for content research - Export podcast metadata to CSV, JSON, Google Sheets, or Make/Zapier workflows - Create datasets for AI summarization pipelines using public episode metadata ### Input #### Podcast feed URLs Add one or more public `http://` or `https://` RSS/Atom feed URLs. Local, private-network, malformed, FTP, and non-HTTP URLs are rejected. #### Maximum total episodes `maxResults` limits how many unique episode items are saved across all feeds. #### Maximum episodes per feed `maxEpisodesPerFeed` controls how many episodes are parsed from each feed before the global limit is applied. #### Include descriptions Turn `includeDescriptions` off if you want smaller datasets and only need episode-level metadata. ### Example input ```json { "feedUrls": [ { "url": "https://feeds.simplecast.com/54nAGcIl" }, { "url": "https://feeds.npr.org/510289/podcast.xml" } ], "maxResults": 20, "maxEpisodesPerFeed": 10, "maxFeeds": 2, "includeDescriptions": true, "requestTimeoutSecs": 30 } ```` ### Output Each podcast episode is saved as one item in the Apify Dataset. | Field | Meaning | |---|---| | `feedUrl` | Source RSS/Atom feed URL | | `podcastTitle` | Podcast/show title from the feed | | `episodeTitle` | Episode title | | `episodeUrl` | Public episode page URL when provided | | `audioUrl` | Direct audio enclosure URL when provided | | `publishedAt` | ISO publish timestamp when parseable | | `duration` | Original podcast duration value | | `durationSeconds` | Duration normalized to seconds when possible | | `description` | Cleaned episode description, if enabled | | `guid` | Feed episode GUID | | `error` | Error message for failed feed-level output rows | | `extractedAt` | ISO timestamp of extraction | ### Example output ```json { "feedUrl": "https://feeds.simplecast.com/54nAGcIl", "podcastTitle": "Example Podcast", "episodeTitle": "How to research a niche", "episodeUrl": "https://example.com/episodes/research", "audioUrl": "https://cdn.example.com/audio.mp3", "publishedAt": "2026-01-01T12:00:00.000Z", "duration": "42:10", "durationSeconds": 2530, "description": "A cleaned episode description.", "guid": "episode-guid", "error": null, "extractedAt": "2026-07-04T00:00:00.000Z" } ``` ### Limitations - The Actor supports public RSS and Atom feeds only. - It does not download audio files. - It does not transcribe or summarize episodes. - Some feeds omit fields like audio URL, duration, or episode page URL. - Very unusual XML structures may not map every field perfectly. - Private feeds, login-only feeds, and blocked URLs are not supported. ### Suggested Pay Per Event pricing Recommended primary event: one extracted episode / default dataset item. Suggested launch price: **$0.30 per 1,000 extracted episodes** plus Apify platform usage costs. This keeps the Actor inexpensive for researchers while monetizing recurring feed monitoring and bulk exports. ### SEO title suggestion Podcast RSS Episode Extractor - Podcast Feed to JSON API ### SEO description suggestion Extract podcast episodes from public RSS and Atom feeds. Get episode titles, URLs, audio links, publish dates, durations, descriptions, and GUIDs as clean JSON or CSV. ### Support and maintenance If a feed fails, check the `error` field first. Common causes are invalid URLs, private feeds, malformed XML, timeouts, or feeds that return HTML instead of RSS/Atom XML. # Actor input Schema ## `feedUrls` (type: `array`): Public RSS or Atom podcast feed URLs to extract episodes from. ## `maxResults` (type: `integer`): Stops after this many unique episode items across all feeds. ## `maxEpisodesPerFeed` (type: `integer`): Limits how many episodes are extracted from each feed before global maxResults is applied. ## `maxFeeds` (type: `integer`): Stops after this many unique feed URLs. ## `includeDescriptions` (type: `boolean`): Include cleaned episode descriptions. Turn off for smaller datasets. ## `requestTimeoutSecs` (type: `integer`): How long to wait for each feed request before recording an error. ## Actor input object example ```json { "feedUrls": [ { "url": "https://feeds.simplecast.com/54nAGcIl" }, { "url": "https://feeds.npr.org/510289/podcast.xml" } ], "maxResults": 10, "maxEpisodesPerFeed": 5, "maxFeeds": 2, "includeDescriptions": true, "requestTimeoutSecs": 30 } ``` # Actor output Schema ## `results` (type: `string`): Open the default dataset in Apify Console. The dataset schema selects a clean table view with the most useful fields first. # 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 = { "feedUrls": [ { "url": "https://feeds.simplecast.com/54nAGcIl" }, { "url": "https://feeds.npr.org/510289/podcast.xml" } ], "maxResults": 10, "maxEpisodesPerFeed": 5, "maxFeeds": 2, "includeDescriptions": true, "requestTimeoutSecs": 30 }; // Run the Actor and wait for it to finish const run = await client.actor("s3nafps/podcast-rss-episode-extractor").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 = { "feedUrls": [ { "url": "https://feeds.simplecast.com/54nAGcIl" }, { "url": "https://feeds.npr.org/510289/podcast.xml" }, ], "maxResults": 10, "maxEpisodesPerFeed": 5, "maxFeeds": 2, "includeDescriptions": True, "requestTimeoutSecs": 30, } # Run the Actor and wait for it to finish run = client.actor("s3nafps/podcast-rss-episode-extractor").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 '{ "feedUrls": [ { "url": "https://feeds.simplecast.com/54nAGcIl" }, { "url": "https://feeds.npr.org/510289/podcast.xml" } ], "maxResults": 10, "maxEpisodesPerFeed": 5, "maxFeeds": 2, "includeDescriptions": true, "requestTimeoutSecs": 30 }' | apify call s3nafps/podcast-rss-episode-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=s3nafps/podcast-rss-episode-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Podcast RSS Episode Extractor", "description": "Extract clean podcast episode data from public RSS and Atom feeds. Get episode titles, episode URLs, audio URLs, publish dates, durations, descriptions, GUIDs, and show titles as structured JSON or CSV.", "version": "0.1", "x-build-id": "dJbs9ox82bqUd0iCI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s3nafps~podcast-rss-episode-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s3nafps-podcast-rss-episode-extractor", "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/s3nafps~podcast-rss-episode-extractor/runs": { "post": { "operationId": "runs-sync-s3nafps-podcast-rss-episode-extractor", "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/s3nafps~podcast-rss-episode-extractor/run-sync": { "post": { "operationId": "run-sync-s3nafps-podcast-rss-episode-extractor", "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", "required": [ "feedUrls" ], "properties": { "feedUrls": { "title": "Podcast feed URLs", "type": "array", "description": "Public RSS or Atom podcast feed URLs to extract episodes from.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum total episodes", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops after this many unique episode items across all feeds.", "default": 100 }, "maxEpisodesPerFeed": { "title": "Maximum episodes per feed", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Limits how many episodes are extracted from each feed before global maxResults is applied.", "default": 100 }, "maxFeeds": { "title": "Maximum feeds", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stops after this many unique feed URLs.", "default": 10 }, "includeDescriptions": { "title": "Include episode descriptions", "type": "boolean", "description": "Include cleaned episode descriptions. Turn off for smaller datasets.", "default": true }, "requestTimeoutSecs": { "title": "Request timeout in seconds", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each feed request before recording an error.", "default": 30 } } }, "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 } } } } } } } } } } ```