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.
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 showsGET /shows?ids=up to 50 shows in a single callGET /shows/{id}?market=full metadata for one showGET /shows/{id}/episodes?offset=&limit=paginated episodes, 50 per pageGET /episodes?ids=batch fetch up to 50 episodesGET /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.