# Spotify Show Episodes Get podcast episodes. One page by default; ask for all=true to walk the full episode history, where each page is a separate upstream lookup charged separately. The walk stops at 1,000 items or a 20-second budget, whichever comes first, and truncated=true says so. - **Documentation:** [https://scrappa.co/docs/spotify-api/spotify_show_episodes](https://scrappa.co/docs/spotify-api/spotify_show_episodes) - **API group:** Spotify API - **Endpoint:** `GET https://scrappa.co/api/spotify/show/episodes` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes |

Spotify show id or full spotify:show: URI.

| | `limit` | integer | No |

Maximum number of items to return.

| | `all` | boolean | No |

Walk the whole list. Cannot be combined with limit. Each page is a separate upstream lookup and is charged separately; the walk stops at 1,000 items or a 20-second budget, whichever comes first, and truncated=true says so.

| ## Example response ```json { "show_id": "4rOoJ6Egrf8K2IrywzwOMk", "episodes": [ { "uid": "2bdfddc56494ad2a832e", "entity": { "_uri": "spotify:episode:67zbYPhb21rCrnfoRomi54", "data": { "id": "67zbYPhb21rCrnfoRomi54", "uri": "spotify:episode:67zbYPhb21rCrnfoRomi54", "name": "JRE MMA Show #186 with Sean Sharaf", "type": "PODCAST_EPISODE", "audio": { "items": [ { "url": "https://p.scdn.co/mp3-preview/c56a64a911eff112d0aafbd71c4ba418867107ad" }, { "url": "https://p.scdn.co/mp3-preview/d96f645e1a813b11f17d535cac22920787372b0f" }, { "url": "https://p.scdn.co/mp3-preview/e5d48cae2ad99a5c8f5c22351ad55b5a1d44224f" }, { "url": "https://p.scdn.co/mp3-preview/ce4001bdeb06de008c4925e1f01060fbfbfaf779" }, { "url": "https://p.scdn.co/mp3-preview/d31270900e848bd57bc243865b02abf840299d3e" }, { "url": "https://p.scdn.co/mp3-preview/68a63dd6b1706ad9018760fc9ddedbdc233573e4" } ] }, "creator": null, "contents": [], "coverArt": { "sources": [ { "url": "https://i.scdn.co/image/ab6765630000f68df29e5f4e549ed4d7968c267d", "width": 64, "height": 64 }, { "url": "https://i.scdn.co/image/ab67656300005f1ff29e5f4e549ed4d7968c267d", "width": 300, "height": 300 }, { "url": "https://i.scdn.co/image/ab6765630000ba8af29e5f4e549ed4d7968c267d", "width": 640, "height": 640 } ] }, "duration": { "totalMilliseconds": 8126825 }, "segments": null, "podcastV2": { "data": { "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk", "name": "The Joe Rogan Experience", "coverArt": { "sources": [ { "url": "https://i.scdn.co/image/ab6765630000f68d5aa94478c5dee97e46924496", "width": 64, "height": 64 }, { "url": "https://i.scdn.co/image/ab67656300005f1f5aa94478c5dee97e46924496", "width": 300, "height": 300 }, { "url": "https://i.scdn.co/image/ab6765630000ba8a5aa94478c5dee97e46924496", "width": 640, "height": 640 } ] }, "showTypes": [ "SHOW_TYPE_EXCLUSIVE" ], "trailerV2": null, "__typename": "Podcast", "accessInfo": null } }, "__typename": "Episode", "accessInfo": null, "mediaTypes": [ "AUDIO", "VIDEO" ], "description": "Joe sits down with Sean Sharaf, a professional mixed martial artist competing in the UFC\u2019s heavyweight division. Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan. This episode is brought to you by Uber Eats. Get almost almost anything. Order now. This video is sponsored by BetterHelp. Visit https://BetterHelp.com/JRE Learn more about your ad choices. Visit podcastchoices.com/adchoices", "playability": { "reason": "PLAYABLE", "playable": true, "unplayabilityReasons": [] }, "playedState": { "state": "NOT_STARTED", "playPositionMilliseconds": 0 }, "releaseDate": { "isoString": "2026-10-01T17:00:00Z", "precision": "MINUTE" }, "sharingInfo": { "shareId": "BpFAPHN6TiubYgQDDeVtYA", "shareUrl": "https://open.spotify.com/episode/67zbYPhb21rCrnfoRomi54?si=BpFAPHN6TiubYgQDDeVtYA" }, "transcripts": { "items": [] }, "restrictions": { "paywallContent": false }, "contentRating": { "label": "EXPLICIT" }, "visualIdentity": { "squareCoverImage": { "__typename": "VisualIdentityImage", "extractedColorSet": { "minContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundBase": { "red": 247, "blue": 0, "alpha": 255, "green": 111 }, "textBrightAccent": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundTintedBase": { "red": 217, "blue": 0, "alpha": 255, "green": 83 } }, "highContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 154, "alpha": 255, "green": 192 }, "backgroundBase": { "red": 145, "blue": 0, "alpha": 255, "green": 48 }, "textBrightAccent": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundTintedBase": { "red": 97, "blue": 0, "alpha": 255, "green": 9 } }, "higherContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 154, "alpha": 255, "green": 192 }, "backgroundBase": { "red": 101, "blue": 0, "alpha": 255, "green": 10 }, "textBrightAccent": { "red": 30, "blue": 96, "alpha": 255, "green": 215 }, "backgroundTintedBase": { "red": 144, "blue": 40, "alpha": 255, "green": 55 } }, "encoreBaseSetTextColor": { "red": 255, "blue": 110, "alpha": 255, "green": 165 } } }, "sixteenByNineCoverImage": { "image": { "data": { "sources": [ { "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000015be4e7f704deb10296248e92b44", "maxWidth": 640, "maxHeight": 360 }, { "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000016924e7f704deb10296248e92b44", "maxWidth": 1280, "maxHeight": 720 } ], "__typename": "ImageV2" } } } }, "htmlDescription": "

Joe sits down with Sean Sharaf, a professional mixed martial artist competing in the UFC\u2019s heavyweight division.

\n


\n

Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan.

\n


\n

This episode is brought to you by Uber Eats. Get almost almost anything. Order now.

\n


\n

This video is sponsored by BetterHelp. Visit https://BetterHelp.com/JRE

Learn more about your ad choices. Visit podcastchoices.com/adchoices

", "previewPlayback": { "audioPreview": { "cdnUrl": "https://p.scdn.co/mp3-preview/6f3afe12f9ca473c9be5a850b441ab5352a00d56.mp3" } }, "contentInformation": null, "gatedEntityRelations": [] } } }, { "uid": "6745113f281ab25f8a75", "entity": { "_uri": "spotify:episode:0p7hBnYGZwXIxHEVPfHM0B", "data": { "id": "0p7hBnYGZwXIxHEVPfHM0B", "uri": "spotify:episode:0p7hBnYGZwXIxHEVPfHM0B", "name": "#2560 - David Grusch", "type": "PODCAST_EPISODE", "audio": { "items": [ { "url": "https://p.scdn.co/mp3-preview/c8571a3a37ad5e7cd0e07c65baed0ef76fdfc34c" }, { "url": "https://p.scdn.co/mp3-preview/184fa608602985516f2d2372b2ca9c6131fc3497" }, { "url": "https://p.scdn.co/mp3-preview/a2426cd37344680dd9baedb49c8f3f87d95c00e7" }, { "url": "https://p.scdn.co/mp3-preview/7cd154bd634cf8934cc8e22f381431cb3f251249" }, { "url": "https://p.scdn.co/mp3-preview/20bbe8045ac8f715c136bc01a68d713d20df741b" }, { "url": "https://p.scdn.co/mp3-preview/07b5075e0593ae1ce20300a1bd687149971e423c" } ] }, "creator": null, "contents": [], "coverArt": { "sources": [ { "url": "https://i.scdn.co/image/ab6765630000f68db8b176deed5eb3c23d4e860e", "width": 64, "height": 64 }, { "url": "https://i.scdn.co/image/ab67656300005f1fb8b176deed5eb3c23d4e860e", "width": 300, "height": 300 }, { "url": "https://i.scdn.co/image/ab6765630000ba8ab8b176deed5eb3c23d4e860e", "width": 640, "height": 640 } ] }, "duration": { "totalMilliseconds": 9025791 }, "segments": null, "podcastV2": { "data": { "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk", "name": "The Joe Rogan Experience", "coverArt": { "sources": [ { "url": "https://i.scdn.co/image/ab6765630000f68d5aa94478c5dee97e46924496", "width": 64, "height": 64 }, { "url": "https://i.scdn.co/image/ab67656300005f1f5aa94478c5dee97e46924496", "width": 300, "height": 300 }, { "url": "https://i.scdn.co/image/ab6765630000ba8a5aa94478c5dee97e46924496", "width": 640, "height": 640 } ] }, "showTypes": [ "SHOW_TYPE_EXCLUSIVE" ], "trailerV2": null, "__typename": "Podcast", "accessInfo": null } }, "__typename": "Episode", "accessInfo": null, "mediaTypes": [ "AUDIO", "VIDEO" ], "description": "David Grusch is a former United States Air Force intelligence officer, former representative of the National Reconnaissance Office to the Unidentified Aerial Phenomena Task Force, and former co-lead for Unidentified Anomalous Phenomena analysis at the National Geospatial-Intelligence Agency. Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan. Get a free welcome kit with your first subscription of AG1 at https://drinkag1.com/joerogan Learn more about your ad choices. Visit podcastchoices.com/adchoices", "playability": { "reason": "PLAYABLE", "playable": true, "unplayabilityReasons": [] }, "playedState": { "state": "NOT_STARTED", "playPositionMilliseconds": 0 }, "releaseDate": { "isoString": "2026-09-30T17:00:00Z", "precision": "MINUTE" }, "sharingInfo": { "shareId": "X39hDpv_RU2nTv99gE20rQ", "shareUrl": "https://open.spotify.com/episode/0p7hBnYGZwXIxHEVPfHM0B?si=X39hDpv_RU2nTv99gE20rQ" }, "transcripts": { "items": [] }, "restrictions": { "paywallContent": false }, "contentRating": { "label": "EXPLICIT" }, "visualIdentity": { "squareCoverImage": { "__typename": "VisualIdentityImage", "extractedColorSet": { "minContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundBase": { "red": 247, "blue": 0, "alpha": 255, "green": 111 }, "textBrightAccent": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundTintedBase": { "red": 217, "blue": 0, "alpha": 255, "green": 83 } }, "highContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 154, "alpha": 255, "green": 192 }, "backgroundBase": { "red": 145, "blue": 0, "alpha": 255, "green": 48 }, "textBrightAccent": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "backgroundTintedBase": { "red": 97, "blue": 0, "alpha": 255, "green": 9 } }, "higherContrast": { "textBase": { "red": 255, "blue": 255, "alpha": 255, "green": 255 }, "textSubdued": { "red": 255, "blue": 154, "alpha": 255, "green": 192 }, "backgroundBase": { "red": 101, "blue": 0, "alpha": 255, "green": 10 }, "textBrightAccent": { "red": 30, "blue": 96, "alpha": 255, "green": 215 }, "backgroundTintedBase": { "red": 144, "blue": 40, "alpha": 255, "green": 55 } }, "encoreBaseSetTextColor": { "red": 255, "blue": 110, "alpha": 255, "green": 165 } } }, "sixteenByNineCoverImage": { "image": { "data": { "sources": [ { "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000015bee8489f73bfe40a393d85824a", "maxWidth": 640, "maxHeight": 360 }, { "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab00001692e8489f73bfe40a393d85824a", "maxWidth": 1280, "maxHeight": 720 } ], "__typename": "ImageV2" } } } }, "htmlDescription": "

David Grusch is a former United States Air Force intelligence officer, former representative of the National Reconnaissance Office to the Unidentified Aerial Phenomena Task Force, and former co-lead for Unidentified Anomalous Phenomena analysis at the National Geospatial-Intelligence Agency.

\n


\n

Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan.

\n


\n

Get a free welcome kit with your first subscription of AG1 at https://drinkag1.com/joerogan

Learn more about your ad choices. Visit podcastchoices.com/adchoices

", "previewPlayback": { "audioPreview": { "cdnUrl": "https://p.scdn.co/mp3-preview/94c8918fa49ebcfce32cc6b9c780ab69b366c1a6.mp3" } }, "contentInformation": null, "gatedEntityRelations": [] } } } ], "returned": 2, "truncated": true, "total_count": 2759, "search_parameters": { "id": "4rOoJ6Egrf8K2IrywzwOMk", "limit": 50, "engine": "spotify_show_episodes" } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 404 | Not Found | No Spotify data exists for the requested id or chart key. Failed requests are never charged. | | 422 | Validation Error | A required parameter is missing or invalid. See the errors object for the offending field. | | 503 | Upstream Unavailable | Spotify could not be reached or returned an unusable response. This is a failed request and is never charged; it is safe to retry. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)