Spotify Podcasts

Search shows, browse episodes, build podcast products

Search Shows

Popular shows:

Spotify Podcasts & Shows API

Pull structured podcast data straight from Spotify: show metadata, paginated episode lists, audio preview URLs, and per-episode descriptions. Whether you're building a podcast directory, a transcription pipeline, or an alternative client, the Shows endpoints give you a clean REST surface without OAuth.

  • /search?q=&type=shows — keyword search across the public show catalog
  • /shows?ids= — fetch up to 50 shows in a single call
  • /shows/{id}?market= — full metadata for a single show
  • /shows/{id}/episodes?offset=&limit= — paginated episodes (max 50/page)
  • /episodes?ids= — batch fetch up to 50 episodes
  • /episodes/{id}?market= — single episode with audio_preview_url

What you can build

Podcast aggregators

Index thousands of shows, surface trending episodes, and offer better discovery than the native Spotify UI.

Transcription pipelines

Stream the audio_preview_url or full episode metadata into Whisper / Deepgram for search-friendly transcripts.

Podcast SEO tools

Track episode titles, descriptions, and publishing cadence to help creators improve discoverability.

Advertising buyers

Map shows by publisher and topic for sponsorship targeting and competitive ad-spend research.

Podcast charts

Rank shows and episodes by your own metrics — duration, freshness, publisher cadence — and publish leaderboards.

Listening apps

Build a reading-app-style UX (queues, bookmarks, speed control) on top of Spotify's catalog.

Alternative clients

Power minimalist, ad-free, or accessibility-focused podcast clients backed by Spotify's metadata.

FAQ

Can I fetch full audio with this endpoint?

No. Spotify only exposes the audio_preview_url (typically 30-60 seconds). Full episode playback requires the Spotify Web Playback SDK with a Premium user OAuth token.

How big is the show catalog?

Spotify's catalog includes millions of shows. /search returns the same paginated results you see in the Spotify app.

What's the page size limit for /shows/{id}/episodes?

50 episodes per page. Increment offset by 50 until you've reached the show's total_episodes count.

Can I batch-fetch multiple shows in one call?

Yes. /shows?ids=id1,id2,...,id50 accepts up to 50 comma-separated IDs per request.

Does episode data include chapter / segment markers?

Episode descriptions and durations are returned. Chapter timestamps are inconsistently provided by publishers; check the description field.

Get production access

Pick the platform that fits your billing & infra.