Catalog

Podcasts

Search Spotify's public show catalog, then open any show for its paginated episode list, release dates and audio previews — no OAuth anywhere in the chain.

Try

GET /search?type=multi (podcasts bucket)

The shows and episodes surface

Show metadata, paginated episode lists, audio preview URLs and per-episode descriptions — a plain REST surface for podcast directories, transcription pipelines and alternative clients.

  • GET /search?q=&type=multikeyword search; the podcasts bucket carries the shows
  • GET /shows?ids=up to 50 shows in a single call
  • GET /shows/{id}?market=full metadata for one show
  • GET /shows/{id}/episodes?offset=&limit=paginated episodes, 50 per page
  • GET /episodes?ids=batch fetch up to 50 episodes
  • GET /episodes/{id}?market=single episode, including 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 and infrastructure.