# Podcast Scraper: Apple Charts, Shows, Hosts & Episodes (`tacps126/podcasts`) Actor

Podcasts from Apple Podcasts search, top charts (any country and genre) and links, with each show's owner name and email, website, language, categories, episode count, posting frequency and last episode, plus episodes with audio and transcript links.

- **URL**: https://apify.com/tacps126/podcasts.md
- **Developed by:** [Tapaswai Choudhary](https://apify.com/tacps126) (community)
- **Categories:** Social media, Lead generation, Automation
- **Security:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.20 / 1,000 podcasts

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/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

## Podcast Scraper — Apple Charts, Shows, Hosts & Episodes

Podcasts from **Apple Podcasts** search, **top charts** (any country, any genre) and links, enriched from each show's own RSS feed: **owner name and contact email**, website, language, categories, episode count, how often it posts and when it last did. Add the latest **episodes** with dates, durations, audio and transcript links.

**Built for** podcast booking and PR agencies pitching guests, advertisers and sponsorship teams, creators researching their niche, market researchers, and AI agents.

### What you get

| Field | Meaning |
|---|---|
| `title`, `author`, `appleId`, `appleUrl`, `feedUrl`, `artwork` | The show |
| `ownerName`, `ownerEmail`, `website` | Who runs it and how to reach them (as published in the feed) |
| `genre`, `genres`, `categories`, `language`, `explicit`, `country` | What it is |
| `episodeCount`, `firstEpisodeDate`, `lastEpisodeDate`, `averageDaysBetweenEpisodes` | How active it is |
| `source`, `rank` | Which search or chart found it, and its position |
| Episodes: `title`, `publishedAt`, `durationSeconds`, `episode`, `season`, `description`, `audioUrl`, `transcriptUrl` | With *Include episodes* |

### Why this Actor

- **Search, charts and links** in one run; top charts for 19 genres in any Apple country.
- **Contacts from the source:** the owner email publishers put in their own RSS feed.
- **Find active shows:** filter by minimum episodes, posted in the last N days, language, with email only, no explicit.
- **New shows alerts:** schedule a chart with *Only new podcasts* to catch shows entering it.
- **For AI agents.** Callable as an MCP tool.

### How to use it

Active US tech podcasts with a contact email:

```json
{ "chartGenres": ["Technology", "Business"], "country": "us", "maxPerSource": 200, "withEmailOnly": true, "activeWithinDays": 30 }
```

### Pricing

**$4 per 1,000 podcasts** and **$1 per 1,000 episodes**, plus a small start fee per run. On the Apify free plan a run returns up to 100 podcasts.

### Good to know

- Emails are those the podcast owner published in their feed for directories; use them for relevant, personal outreach and follow the law where you are (CAN-SPAM, GDPR).
- A few feeds are offline or private; those podcasts still come with their Apple details and a `feedError`.
- Questions: **tacps126@gmail.com**.

# Actor input Schema

## `searchTerms` (type: `array`):

Podcasts matching these words in Apple Podcasts.

## `chartGenres` (type: `array`):

Apple's top podcasts for these genres (All = the overall chart).

## `podcasts` (type: `array`):

Apple Podcasts links or ids, or RSS feed links.

## `country` (type: `string`):

Two-letter store country for search and charts, e.g. us, gb, in, de.

## `maxPerSource` (type: `integer`):

Charts go up to 200.

## `includeEpisodes` (type: `boolean`):

Also return the latest episodes of each podcast (title, date, duration, audio and transcript links).

## `maxEpisodesPerPodcast` (type: `integer`):

Newest first.

## `minEpisodes` (type: `integer`):

Leave out podcasts with fewer episodes.

## `activeWithinDays` (type: `integer`):

Only podcasts with an episode in this window (active shows).

## `withEmailOnly` (type: `boolean`):

Only podcasts whose feed lists an owner email.

## `languages` (type: `array`):

Feed language codes, e.g. en, es, de.

## `excludeExplicit` (type: `boolean`):

Drop podcasts marked explicit.

## `maxItems` (type: `integer`):

Most podcasts returned per run.

## `onlyNew` (type: `boolean`):

Schedule the Actor and each run returns only podcasts earlier runs did not deliver (new shows entering a chart or search).

## `monitorName` (type: `string`):

Optional name for the “only new” history, so several monitors can run side by side.

## `tenantId` (type: `string`):

Optional label used to keep separate histories for different clients or teams.

## `debug` (type: `boolean`):

Save extra diagnostics with the run (for support requests).

## Actor input object example

```json
{
  "searchTerms": [
    "startup"
  ],
  "country": "us",
  "maxPerSource": 50,
  "includeEpisodes": false,
  "maxEpisodesPerPodcast": 10,
  "withEmailOnly": false,
  "excludeExplicit": false,
  "maxItems": 500,
  "onlyNew": false,
  "debug": false
}
```

# Actor output Schema

## `results` (type: `string`):

The produced items (default dataset items).

# 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 = {
    "searchTerms": [
        "startup"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tacps126/podcasts").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 = { "searchTerms": ["startup"] }

# Run the Actor and wait for it to finish
run = client.actor("tacps126/podcasts").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 '{
  "searchTerms": [
    "startup"
  ]
}' |
apify call tacps126/podcasts --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tacps126/podcasts"
        }
    }
}
```

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/HJbTZWHCSge5dWf7M/builds/7CB97NBheeHc55GDQ/openapi.json