Podcast Bölümleri

GET/v1/spotify/podcast/episodes1 kredi

Bir podcast'in bölümlerini sayfa başına 50 adet listeler; her bölümün başlığı, açıklaması, yayın tarihi, süresi, ses bilgileri, kapak görseli ve içerik derecelendirmesi yer alır.

01Sorgu parametreleri

Ad	Tür	Açıklama
idisteğe bağlı	string	Spotify program kimliği, örneğin `4rOoJ6Egrf8K2IrywzwOMk`. `id` ya da `url` parametrelerinden biri zorunludur; ikisi birden verilirse `id` kullanılır.
urlisteğe bağlı	string	open.spotify.com program URL'si. `id` ya da `url` parametrelerinden biri zorunludur.
cursoristeğe bağlı	integer	Bir önceki sayfanın sayısal `cursor` değeri (`50` gibi bir konum); sonraki sayfayı almak için geri gönderilir. Verilmezse 0'dan başlar.Varsayılan: `0`

02İstek

curl "https://api.scrapesocial.ai/v1/spotify/podcast/episodes?id=4rOoJ6Egrf8K2IrywzwOMk" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/spotify/podcast/episodes?id=4rOoJ6Egrf8K2IrywzwOMk

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "4rOoJ6Egrf8K2IrywzwOMk",
  "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
  "episodes": [
    {
      "__typename": "Episode",
      "accessInfo": null,
      "audio": [
        {
          "url": "https://p.scdn.co/mp3-preview/e5bc2b51db8fa1948d61f27a28848c0a09e930eb"
        },
        {
          "url": "https://p.scdn.co/mp3-preview/403d868c387bbf5c6d7b6df05e27a35437e86f35"
        }
      ],
      "contentInformation": null,
      "contentRating": {
        "label": "EXPLICIT"
      },
      "contentRatingsV2": {
        "labels": [
          "EXPLICIT"
        ]
      },
      "contents": [],
      "coverArt": {
        "sources": [
          {
            "height": 64,
            "url": "https://i.scdn.co/image/ab6765630000f68de3dfbd869a297cdc95fd1077",
            "width": 64
          },
          {
            "height": 300,
            "url": "https://i.scdn.co/image/ab67656300005f1fe3dfbd869a297cdc95fd1077",
            "width": 300
          }
        ]
      },
      "creator": null,
      "description": "Kurt Metzger and Duncan Trussell are comedians and co-hosts of the \"Mystery Boys\" podcast. They also host their respective podcasts, \"The Derp with Kurp\" and \"The Duncan Trussell Family Hour.\"www.ymhstudios.com/mystery-boys-podcast/www.youtube.com/@duncantrussellfamilyhourwww.duncantrussell.comwww.youtube.com/@kurtmetzgercomedywww.kurtmetzgercomedy.com  Perplexity: Download the app or ask Perplexi…",
      "duration": {
        "totalMilliseconds": 9821140
      },
      "gatedEntityRelations": [],
      "htmlDescription": "<p>Kurt Metzger and Duncan Trussell are comedians and co-hosts of the &#34;Mystery Boys&#34; podcast. They also host their respective podcasts, &#34;The Derp with Kurp&#34; and &#34;The Duncan Trussell Family Hour.&#34;<br />www.ymhstudios.com/mystery-boys-podcast/<br />www.youtube.com/&#64;duncantrussellfamilyhour<br />www.duncantrussell.com<br />www.youtube.com/&#64;kurtmetzgercomedy<br />www.ku…",
      "id": "2rKMiQw2A58GL5ZHH8jfHo",
      "mediaTypes": [
        "VIDEO",
        "AUDIO"
      ],
      "name": "#2570 - Mystery Boys",
      "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/ab6765630000f68de7c95712f4940a9bf439467e",
              "width": 64
            },
            {
              "height": 300,
              "url": "https://i.scdn.co/image/ab67656300005f1fe7c95712f4940a9bf439467e",
              "width": 300
            }
          ]
        },
        "name": "The Joe Rogan Experience",
        "showTypes": [
          "SHOW_TYPE_EXCLUSIVE"
        ],
        "trailerV2": null,
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
        "accessInfo": null
      },
      "previewPlayback": {
        "audioPreview": {
          "cdnUrl": "https://p.scdn.co/mp3-preview/65e7d11e09ef8338f6cf792207da2e9b4f556861.mp3"
        }
      },
      "releaseDate": {
        "isoString": "2026-10-23T17:00:00Z",
        "precision": "MINUTE"
      },
      "restrictions": {
        "paywallContent": false
      },
      "segments": null,
      "sharingInfo": {
        "shareId": "iOv9cQ3oR-KOSZ-CXM5hMw",
        "shareUrl": "https://open.spotify.com/episode/2rKMiQw2A58GL5ZHH8jfHo?si=iOv9cQ3oR-KOSZ-CXM5hMw"
      },
      "transcripts": [],
      "type": "PODCAST_EPISODE",
      "uri": "spotify:episode:2rKMiQw2A58GL5ZHH8jfHo",
      "visualIdentity": {
        "sixteenByNineCoverImage": {
          "image": {
            "__typename": "ImageV2",
            "sources": [
              {
                "maxHeight": 720,
                "maxWidth": 1280,
                "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000030aeb1bc779505bae7d8f8daa997"
              },
              {
                "maxHeight": 360,
                "maxWidth": 640,
                "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab0000e0e7b1bc779505bae7d8f8daa997"
              }
            ]
          }
        },
        "squareCoverImage": {
          "__typename": "VisualIdentityImage",
          "extractedColorSet": {
            "encoreBaseSetTextColor": {
              "alpha": 255,
              "blue": 110,
              "green": 165,
              "red": 255
            },
            "highContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 48,
                "red": 145
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 0,
                "green": 9,
                "red": 97
              },
              "textBase": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textBrightAccent": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textSubdued": {
                "alpha": 255,
                "blue": 154,
                "green": 192,
                "red": 255
              }
            },
            "higherContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 10,
                "red": 101
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 40,
                "green": 55,
                "red": 144
              },
              "textBase": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textBrightAccent": {
                "alpha": 255,
                "blue": 96,
                "green": 215,
                "red": 30
              },
              "textSubdued": {
                "alpha": 255,
                "blue": 154,
                "green": 192,
                "red": 255
              }
            },
            "minContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 111,
                "red": 247
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 0,
                "green": 83,
                "red": 217
              },
              "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
              }
            }
          }
        }
      }
    },
    {
      "__typename": "Episode",
      "accessInfo": null,
      "audio": [
        {
          "url": "https://p.scdn.co/mp3-preview/b965c2138ddd98718e792c05a5366bde6ec5c71f"
        },
        {
          "url": "https://p.scdn.co/mp3-preview/703986b3d6646dc7919d476ac6b3e8337abc6535"
        }
      ],
      "contentInformation": null,
      "contentRating": {
        "label": "EXPLICIT"
      },
      "contentRatingsV2": {
        "labels": [
          "EXPLICIT"
        ]
      },
      "contents": [],
      "coverArt": {
        "sources": [
          {
            "height": 64,
            "url": "https://i.scdn.co/image/ab6765630000f68df5062ebd7f666ab8139aadd6",
            "width": 64
          },
          {
            "height": 300,
            "url": "https://i.scdn.co/image/ab67656300005f1ff5062ebd7f666ab8139aadd6",
            "width": 300
          }
        ]
      },
      "creator": null,
      "description": "Joe sits down with Robert Whittaker, a professional mixed martial artist currently competing in the UFC's light heavyweight division and host of the \"MMArcade\" podcast.www.ascendfitnessbyrob.com/www.musashi.com/pages/reaper-rangewww.patreon.com/cw/MMArcadePodcastwww.youtube.com/@MMArcadePodcastwww.robwhittaker.co  Perplexity: Download the app or ask Perplexity anything at https://pplx.ai/rogan.  D…",
      "duration": {
        "totalMilliseconds": 10135060
      },
      "gatedEntityRelations": [],
      "htmlDescription": "<p>Joe sits down with Robert Whittaker, a professional mixed martial artist currently competing in the UFC&#39;s light heavyweight division and host of the &#34;MMArcade&#34; podcast.<br />www.ascendfitnessbyrob.com/<br />www.musashi.com/pages/reaper-range<br />www.patreon.com/cw/MMArcadePodcast<br />www.youtube.com/&#64;MMArcadePodcast<br />www.robwhittaker.co</p>\n<p><br /></p>\n<p>Perplexity: Dow…",
      "id": "4VkQ1aL4FBrNOHPcSBNGf7",
      "mediaTypes": [
        "VIDEO",
        "AUDIO"
      ],
      "name": "JRE MMA Show #187 with Robert Whittaker",
      "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/ab6765630000f68de7c95712f4940a9bf439467e",
              "width": 64
            },
            {
              "height": 300,
              "url": "https://i.scdn.co/image/ab67656300005f1fe7c95712f4940a9bf439467e",
              "width": 300
            }
          ]
        },
        "name": "The Joe Rogan Experience",
        "showTypes": [
          "SHOW_TYPE_EXCLUSIVE"
        ],
        "trailerV2": null,
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
        "accessInfo": null
      },
      "previewPlayback": {
        "audioPreview": {
          "cdnUrl": "https://p.scdn.co/mp3-preview/e53a1fb9d67d53e627c9170451511ddeaee6bfc0.mp3"
        }
      },
      "releaseDate": {
        "isoString": "2026-10-22T17:00:00Z",
        "precision": "MINUTE"
      },
      "restrictions": {
        "paywallContent": false
      },
      "segments": null,
      "sharingInfo": {
        "shareId": "D65PGtYzTwaWMLCKhkqkCw",
        "shareUrl": "https://open.spotify.com/episode/4VkQ1aL4FBrNOHPcSBNGf7?si=D65PGtYzTwaWMLCKhkqkCw"
      },
      "transcripts": [],
      "type": "PODCAST_EPISODE",
      "uri": "spotify:episode:4VkQ1aL4FBrNOHPcSBNGf7",
      "visualIdentity": {
        "sixteenByNineCoverImage": {
          "image": {
            "__typename": "ImageV2",
            "sources": [
              {
                "maxHeight": 720,
                "maxWidth": 1280,
                "url": "https://image-cdn-fa.spotifycdn.com/image/ab6772ab000030ae4025a19fb64c3f5082687d86"
              },
              {
                "maxHeight": 360,
                "maxWidth": 640,
                "url": "https://image-cdn-fa.spotifycdn.com/image/ab6772ab0000e0e74025a19fb64c3f5082687d86"
              }
            ]
          }
        },
        "squareCoverImage": {
          "__typename": "VisualIdentityImage",
          "extractedColorSet": {
            "encoreBaseSetTextColor": {
              "alpha": 255,
              "blue": 110,
              "green": 165,
              "red": 255
            },
            "highContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 48,
                "red": 145
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 0,
                "green": 9,
                "red": 97
              },
              "textBase": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textBrightAccent": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textSubdued": {
                "alpha": 255,
                "blue": 154,
                "green": 192,
                "red": 255
              }
            },
            "higherContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 10,
                "red": 101
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 40,
                "green": 55,
                "red": 144
              },
              "textBase": {
                "alpha": 255,
                "blue": 255,
                "green": 255,
                "red": 255
              },
              "textBrightAccent": {
                "alpha": 255,
                "blue": 96,
                "green": 215,
                "red": 30
              },
              "textSubdued": {
                "alpha": 255,
                "blue": 154,
                "green": 192,
                "red": 255
              }
            },
            "minContrast": {
              "backgroundBase": {
                "alpha": 255,
                "blue": 0,
                "green": 111,
                "red": 247
              },
              "backgroundTintedBase": {
                "alpha": 255,
                "blue": 0,
                "green": 83,
                "red": 217
              },
              "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": 2770
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Bölümler `episodes` içinde, sayfa başına 50 adet ve `totalCount` ile gelir. Sonraki sayfa için yanıttaki `cursor` değerini (50 gibi bir sayı) `cursor` parametresiyle geri gönderin; son sayfada null olur. Sonun ötesindeki bir sayfa boş bir liste döndürür, 0 kredi düşer. Bulunamayan bir program ücretsiz bir 404 döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.