SPOTIFY API
Podcast Episodes
Retrieve podcast episodes from Spotify with a single API request.
GET
/api/data/v1/spotify/podcast/episodes1credit base cost
Request parameters
Up to 1 creditSpotify podcast id. If you'd prefer to use the URL instead, you can use the url parameter instead.
Spotify podcast URL. If you'd prefer to use the id instead, you can use the id parameter instead.
Cursor returned by the previous response. Omit for the first page.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/spotify/podcast/episodes?id=4rOoJ6Egrf8K2IrywzwOMk' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"id": "3mliji9352UAk3XnWElnDV",
"uri": "spotify:show:3mliji9352UAk3XnWElnDV",
"episodes": [
{
"__typename": "Episode",
"accessInfo": null,
"audio": [
{
"url": "https://p.scdn.co/mp3-preview/2cd8dd37b64a10c1f7cfc194172cca5887006cd3"
}
],
"contentInformation": null,
"contentRating": {
"label": "NONE"
},
"contentRatingsV2": null,
"contents": [],
"coverArt": {
"sources": [
{
"height": 64,
"url": "https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229",
"width": 64
}
]
},
"creator": null,
"description": "Get our Wealth Guide (35+ insights from top investors): https://clickhubspot.com/fvif Episode 828: Shaan Puri ( https://x.com/ShaanVP ) and Sam Parr ( https://x.com/theSamParr ) talk to billionaire Joe Liemandt ( https://x.com/jliemandt ) about the experiment he’s put $1,000,000,000 of his own money into. — Show Notes: (0:00) Joe, the total man? (08:09) fighting bill gates for talent (13:14) intensity (16:18) choosing hard over easy (19:00) how to be a magnet (21:34) high standards (23:29) being persuasive (29:23) simplicity: 3 ines, 3 words (34:41) is 2x faster really better? (36:23) making kids run a 5k (38:45) why be public now (41:01) why put $1b into the lowest roi thing? (50:03) bu",
"duration": {
"totalMilliseconds": 3903344
},
"gatedEntityRelations": [],
"htmlDescription": "<p>Get our Wealth Guide (35+ insights from top investors):<a href=\"https://clickhubspot.com/fvif\" rel=\"nofollow\"> https://clickhubspot.com/fvif</a></p><br/><p><br /></p><br/><p>Episode 828: Shaan Puri ( <a href=\"https://x.com/ShaanVP\" rel=\"nofollow\">https://x.com/ShaanVP</a> ) and Sam Parr ( <a href=\"https://x.com/theSamParr\" rel=\"nofollow\">https://x.com/theSamParr</a> ) talk to billionaire Joe Liemandt ( <a href=\"https://x.com/jliemandt\" rel=\"nofollow\">https://x.com/jliemandt</a> ) about the experiment he’s put $1,000,000,000 of his own money into.</p><br/><p>—</p><br/><p>Show Notes: </p><br/><p>(0:00) Joe, the total man?</p><br/><p>(08:09) fighting bill gates for talent</p><br/><p>(13:",
"id": "3rvl30aWNqZbWi9dnolG3a",
"mediaTypes": [
"AUDIO"
],
"name": "The 50 richest families in America are betting on this trend",
"playability": {
"playable": true,
"reason": "PLAYABLE",
"unplayabilityReasons": []
},
"playedState": {
"playPositionMilliseconds": 0,
"state": "NOT_STARTED"
},
"podcastV2": {
"__typename": "Podcast",
"coverArt": {
"sources": [
{
"height": 64,
"url": "https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229",
"width": 64
}
]
},
"name": "My First Million",
"showTypes": [],
"trailerV2": null,
"uri": "spotify:show:3mliji9352UAk3XnWElnDV",
"accessInfo": null
},
"previewPlayback": {
"audioPreview": {
"cdnUrl": "https://p.scdn.co/mp3-preview/b6e83bb5e3142367e192e45865e7c64cb2f39483.mp3"
}
},
"releaseDate": {
"isoString": "2026-05-27T08:59:00Z",
"precision": "MINUTE"
},
"restrictions": {
"paywallContent": false
},
"segments": null,
"sharingInfo": {
"shareId": "-xrq7hW_Qn2886yuMzLkyg",
"shareUrl": "https://open.spotify.com/episode/3rvl30aWNqZbWi9dnolG3a?si=-xrq7hW_Qn2886yuMzLkyg"
},
"transcripts": [],
"type": "PODCAST_EPISODE",
"uri": "spotify:episode:3rvl30aWNqZbWi9dnolG3a",
"visualIdentity": {
"sixteenByNineCoverImage": {
"image": {
"__typename": "ImageV2",
"sources": [
{
"maxHeight": 720,
"maxWidth": 1280,
"url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000030aeae7253d400b6cde5defd1197"
}
]
}
},
"squareCoverImage": {
"__typename": "VisualIdentityImage",
"extractedColorSet": {
"encoreBaseSetTextColor": {
"alpha": 255,
"blue": 187,
"green": 187,
"red": 187
},
"highContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 72,
"green": 72,
"red": 72
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 33,
"green": 33,
"red": 33
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textSubdued": {
"alpha": 255,
"blue": 205,
"green": 205,
"red": 205
}
},
"higherContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 53,
"green": 53,
"red": 53
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 86,
"green": 86,
"red": 86
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 96,
"green": 215,
"red": 30
},
"textSubdued": {
"alpha": 255,
"blue": 205,
"green": 205,
"red": 205
}
},
"minContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 72,
"green": 72,
"red": 72
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 33,
"green": 33,
"red": 33
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textSubdued": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
}
}
}
}
}
}
],
"cursor": 50,
"totalCount": 868,
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"id": {
"type": "string"
},
"uri": {
"type": "string"
},
"episodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"__typename": {
"type": "string"
},
"accessInfo": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"audio": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
}
}
}
},
"contentInformation": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"contentRating": {
"type": "object",
"properties": {
"label": {
"type": "string"
}
}
},
"contentRatingsV2": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"contents": {
"type": "array"
},
"coverArt": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"creator": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"description": {
"type": "string"
},
"duration": {
"type": "object",
"properties": {
"totalMilliseconds": {
"type": "integer"
}
}
},
"gatedEntityRelations": {
"type": "array"
},
"htmlDescription": {
"type": "string"
},
"id": {
"type": "string"
},
"mediaTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
},
"reason": {
"type": "string"
},
"unplayabilityReasons": {
"type": "array"
}
}
},
"playedState": {
"type": "object",
"properties": {
"playPositionMilliseconds": {
"type": "integer"
},
"state": {
"type": "string"
}
}
},
"podcastV2": {
"type": "object",
"properties": {
"__typename": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"name": {
"type": "string"
},
"showTypes": {
"type": "array"
},
"trailerV2": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"uri": {
"type": "string"
},
"accessInfo": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"previewPlayback": {
"type": "object",
"properties": {
"audioPreview": {
"type": "object",
"properties": {
"cdnUrl": {
"type": "string"
}
}
}
}
},
"releaseDate": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
}
}
},
"restrictions": {
"type": "object",
"properties": {
"paywallContent": {
"type": "boolean"
}
}
},
"segments": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"transcripts": {
"type": "array"
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
},
"visualIdentity": {
"type": "object",
"properties": {
"sixteenByNineCoverImage": {
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"__typename": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"maxHeight": {
"type": "integer"
},
"maxWidth": {
"type": "integer"
},
"url": {
"type": "string"
}
}
}
}
}
}
}
},
"squareCoverImage": {
"type": "object",
"properties": {
"__typename": {
"type": "string"
},
"extractedColorSet": {
"type": "object",
"properties": {
"encoreBaseSetTextColor": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"highContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
},
"higherContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
},
"minContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"cursor": {
"type": "integer"
},
"totalCount": {
"type": "integer"
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}