# Apple Podcast Top Chart Scrapper (`coder_zoro/apple-podcast-top-chart-scrapper`) Actor

Scrape Apple Podcast top charts instantly and get detailed data on trending shows, series, episodes, and subscriber content. Extract metadata, artwork, descriptions, genres, and release info for market research, analytics, and discovery tools.

- **URL**: https://apify.com/coder\_zoro/apple-podcast-top-chart-scrapper.md
- **Developed by:** [Zoro](https://apify.com/coder_zoro) (community)
- **Categories:** Automation, Other
- **Stats:** 51 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Top Chart Scraper

A powerful Apify Actor that scrapes Apple Podcast's top charts across different categories, providing detailed information about trending podcasts, series, episodes, and subscriber content.

### Features

- Scrape multiple Apple Podcast chart categories
- Extract comprehensive podcast metadata
- Get artwork URLs, descriptions, genre information
- Track release dates and episode counts
- Retrieve content ratings and URLs

### Use Cases

#### 1. **Market Research & Competitive Analysis**

- Track trending podcasts in your niche
- Analyze competitor performance on Apple Podcasts
- Identify emerging trends in podcast categories
- Monitor top-performing content for inspiration

#### 2. **Content Discovery & Curation**

- Discover new podcasts to feature in your platform
- Build recommendation systems based on chart performance
- Create curated podcast lists for specific audiences
- Find popular episodes for content aggregation

#### 3. **Media Monitoring & Analytics**

- Track podcast chart positions over time
- Monitor brand mentions in top-performing shows
- Analyze genre popularity and shifts
- Generate reports on podcast industry trends

#### 4. **Marketing & Promotion**

- Identify podcast advertising opportunities
- Research influencer partnerships with popular shows
- Analyze successful podcast marketing strategies
- Track performance of podcast campaigns

#### 5. **Data Journalism & Research**

- Gather data for podcast industry reports
- Analyze content trends and consumer preferences
- Study the podcast ecosystem and its evolution
- Create visualizations of podcast popularity

#### 6. **Product Development**

- Build podcast discovery applications
- Create chart tracking dashboards
- Develop podcast recommendation engines
- Integrate trending content into your platform

### Input Configuration

The Actor accepts a single input parameter:

#### `category` (required)

Select which Apple Podcast chart to scrape:

- **Top Shows** - Most popular podcast shows
- **Top Subscriber Shows** - Top shows among Apple Podcast subscribers
- **Top Series** - Trending podcast series
- **Top Episodes** - Most popular individual episodes
- **Top Subscriber Channel** - Top channels for subscribers

#### Input Schema

```json
{
  "category": "top series"
}
```

### Output Data

The Actor returns an array of podcast objects with the following fields:

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique Apple Podcast identifier |
| `type` | string | Content type (e.g., "podcasts") |
| `name` | string | Podcast name/title |
| `url` | string | Direct link to the podcast on Apple Podcasts |
| `artwork_url` | string | Template URL for podcast artwork (supports variable sizes) |
| `description` | string | Full podcast description |
| `genreNames` | array | List of genres the podcast belongs to |
| `releaseDateTime` | string | ISO 8601 formatted release date of latest episode |
| `trackCount` | number | Total number of available tracks/episodes |
| `content_rating` | string | Content rating (e.g., "clean", "explicit") |
| `episode_count` | number/null | Episode count (if available) |

#### Output Example

```json
[
  {
    "id": "1322200189",
    "type": "podcasts",
    "name": "Crime Junkie",
    "url": "https://podcasts.apple.com/us/podcast/crime-junkie/id1322200189",
    "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts126/v4/8c/35/04/8c350430-2fbf-98d0-0a25-00b76550ffeb/mza_13445204151221888086.jpg/{w}x{h}bb.{f}",
    "description": "Does hearing about a true crime case always leave you scouring the internet for the truth behind the story?...",
    "genreNames": ["True Crime", "Podcasts"],
    "releaseDateTime": "2025-11-27T08:00:00Z",
    "trackCount": 476,
    "content_rating": "clean",
    "episode_count": null
  }
]
```

### How to Run on Apify Console

#### Step 1: Access the Actor

1. Log in to your [Apify Console](https://console.apify.com/)
2. Navigate to **Actors** in the left sidebar
3. Find and click on **Apple Podcast Top Chart Scraper**

#### Step 2: Configure Input

1. In the Actor's input screen, you'll see the **Category** dropdown
2. Select your desired chart category:
   - Top Shows
   - Top Subscriber Shows
   - Top Series
   - Top Episodes
   - Top Subscriber Channel
3. Alternatively, switch to **JSON** input mode and paste your configuration:
   ```json
   {
     "category": "top series"
   }
   ```

#### Step 3: Run the Actor

1. Click the **Start** button at the bottom of the input form
2. The Actor will begin running and you'll see the execution progress
3. Wait for the Actor to complete (usually takes a few seconds to a minute)

#### Step 4: Access Results

Once completed, you can access the scraped data in multiple ways:

##### View in Console

- Click on the **Results** tab to see the data in a table format
- Use the **Preview** option for a quick look at the JSON output

##### Download Data

Click on the **Export** button and choose your preferred format:

- **JSON** - Raw JSON format
- **CSV** - Comma-separated values (spreadsheet-compatible)
- **Excel** - Microsoft Excel format
- **HTML** - Web page format
- **XML** - Extensible Markup Language

#### Step 5: Schedule Regular Runs (Optional)

To track chart changes over time:

1. Click on **Schedule** in the Actor detail page
2. Set up a recurring schedule (hourly, daily, weekly)
3. Configure notification preferences
4. Save the schedule

You can also:

- Set up integrations to push data to your database
- Configure webhooks to notify your systems when runs complete
- Use Apify's integrations with Google Drive, Dropbox, AWS S3, etc.

### Tips for Best Results

1. **Regular Monitoring**: Schedule daily runs to track chart position changes
2. **Multiple Categories**: Run the Actor for different categories to get comprehensive data
3. **Data Integration**: Connect results to your analytics platform for deeper insights
4. **Rate Limiting**: The Actor respects Apple's robots.txt and implements proper rate limiting
5. **Historical Tracking**: Store results over time to analyze trends and patterns

***

**Happy Scraping!** 🎧📊

# Actor input Schema

## `category` (type: `string`):

Select the podcast category to scrape

## Actor input object example

```json
{
  "category": "top shows"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("coder_zoro/apple-podcast-top-chart-scrapper").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("coder_zoro/apple-podcast-top-chart-scrapper").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 '{}' |
apify call coder_zoro/apple-podcast-top-chart-scrapper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=coder_zoro/apple-podcast-top-chart-scrapper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/X8vTxdq1YNX1Re4ZE/builds/OA54nmvnFr1V9Vb5q/openapi.json