Spotify Podcast Scraper

Extract comprehensive podcast data from Spotify's catalog of 5+ million podcasts. Get show metadata, complete episode listings, descriptions, durations, and more using the official Spotify Web API.

Features

• Search Podcasts - Find shows by keyword, topic, or genre
• Show Lookup - Get data for specific shows by ID or URL
• Episode Data - Full episode listings with descriptions, durations, release dates
• Multi-Market Support - Access different country catalogs (US, GB, CA, AU, DE, etc.)
• Official API - Uses Spotify's official Web API for reliable, accurate data

Requirements

Spotify API Credentials (Free)

You need a Spotify Client ID and Client Secret. Get them free:

1. Go to Spotify Developer Dashboard
2. Log in with your Spotify account (or create one free)
3. Click "Create App"
4. Fill in app name and description (anything works)
5. Copy your Client ID and Client Secret

Use Cases

• Podcast Research - Discover podcasts in any niche or topic
• Competitive Analysis - Analyze competitor shows and episode cadence
• Market Intelligence - Track podcast trends and new releases
• Content Planning - Research episode topics and formats
• Advertising Research - Find podcasts for ad placement

Input

Parameter	Type	Required	Description
spotifyClientId	string	Yes	Your Spotify API Client ID
spotifyClientSecret	string	Yes	Your Spotify API Client Secret
mode	string	No	"search" or "show_ids" (default: search)
searchQuery	string	No	Search term (required in search mode)
showIds	array	No	Show IDs or URLs (required in show_ids mode)
market	string	No	Country code (default: US)
maxResults	integer	No	Max shows in search (default: 20, max: 50)
includeEpisodes	boolean	No	Fetch episode data (default: true)
maxEpisodesPerShow	integer	No	Limit episodes per show

Example Input - Search Mode

{
  "spotifyClientId": "your_client_id",
  "spotifyClientSecret": "your_client_secret",
  "mode": "search",
  "searchQuery": "technology news",
  "market": "US",
  "maxResults": 10,
  "includeEpisodes": true,
  "maxEpisodesPerShow": 20
}

Example Input - Show IDs Mode

{
  "spotifyClientId": "your_client_id",
  "spotifyClientSecret": "your_client_secret",
  "mode": "show_ids",
  "showIds": [
    "4rOoJ6Egrf8K2IrywzwOMk",
    "https://open.spotify.com/show/5CfCWKI5pZ28U0uOzXkDHe"
  ],
  "includeEpisodes": true
}

Output

Each show returns comprehensive data:

{
  "id": "4rOoJ6Egrf8K2IrywzwOMk",
  "name": "The Joe Rogan Experience",
  "publisher": "Joe Rogan",
  "description": "The official podcast of comedian Joe Rogan...",
  "total_episodes": 2100,
  "explicit": true,
  "media_type": "audio",
  "languages": ["en"],
  "spotify_url": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
  "images": [
    {"url": "https://i.scdn.co/image/...", "height": 640, "width": 640}
  ],
  "episodes": [
    {
      "id": "episode_id",
      "name": "Episode Title",
      "description": "Episode description...",
      "duration_ms": 10800000,
      "duration_formatted": "3:00:00",
      "release_date": "2024-01-15",
      "explicit": true,
      "spotify_url": "https://open.spotify.com/episode/...",
      "audio_preview_url": "https://p.scdn.co/mp3-preview/..."
    }
  ],
  "episodes_fetched": 20,
  "scraped_at": "2024-01-15T10:30:00.000000"
}

Episode Data Includes

• Episode ID, title, and description
• Duration in milliseconds and formatted (HH:MM:SS)
• Release date with precision (day, month, or year)
• Explicit content flag
• Language(s)
• Spotify URL
• Audio preview URL (30-second clip when available)
• Cover images

Pricing

$0.005 per show ($5 per 1,000 shows)

Episodes are included in the show price - no extra charge.

Rate Limits

The scraper includes built-in rate limiting to respect Spotify's API limits. For large-scale scraping, consider running multiple smaller batches.

Supported Markets

US, GB, CA, AU, DE, FR, ES, IT, NL, SE, NO, DK, FI, AT, CH, BE, IE, NZ, SG, HK, JP, KR, BR, MX, and more.

Legal Notice

This scraper uses the official Spotify Web API. You must comply with Spotify's Developer Terms of Service. The API credentials are free but require a Spotify account.