Podcast

GET/v1/spotify/podcast1 credit

Returns a podcast show: name, publisher, description, cover art, rating, topics, content type and its latest episodes.

01Query parameters

Name	Type	Description
idoptional	string	The Spotify show id, e.g. `4rOoJ6Egrf8K2IrywzwOMk`. One of `id` or `url` is required; `id` wins when both are given.
urloptional	string	The open.spotify.com show URL. One of `id` or `url` is required.

02Request

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

03Responses

Real answers from the API. Lists are shortened to 2 items.

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

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "4rOoJ6Egrf8K2IrywzwOMk",
  "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
  "__typename": "Podcast",
  "accessInfo": null,
  "consumptionOrderV2": "EPISODIC",
  "contentCapabilityTrait": null,
  "contentRatingV2": {
    "labels": [
      "EXPLICIT"
    ]
  },
  "contentType": "CONTENT_TYPE_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
      }
    ]
  },
  "description": "The official podcast of comedian Joe Rogan.",
  "episodesV2": [
    {
      "entity": {
        "__typename": "EpisodeResponseWrapper",
        "data": {
          "__typename": "Episode",
          "creator": null,
          "uri": "spotify:episode:2rKMiQw2A58GL5ZHH8jfHo"
        }
      }
    }
  ],
  "gatedEntityRelations": [],
  "htmlDescription": "<p>The official podcast of comedian Joe Rogan.</p>",
  "mediaType": "MIXED",
  "musicAndTalk": null,
  "name": "The Joe Rogan Experience",
  "playability": {
    "playable": true,
    "reason": "PLAYABLE",
    "unplayabilityReasons": []
  },
  "publisher": {
    "name": "Joe Rogan"
  },
  "rating": {
    "averageRating": {
      "average": 4.651332357523213,
      "showAverage": true,
      "totalRatings": 955787
    },
    "canRate": true,
    "rating": {
      "rating": 0
    }
  },
  "saved": false,
  "sharingInfo": {
    "shareId": "Z-yk1zpiRgyajQTAX_vVgw",
    "shareUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk?si=Z-yk1zpiRgyajQTAX_vVgw"
  },
  "showTypes": [
    "SHOW_TYPE_EXCLUSIVE"
  ],
  "topics": [
    {
      "__typename": "PodcastTopic",
      "title": "Comedy",
      "uri": "spotify:genre:0JQ5DAqbMKFNr6gDrHHVKL"
    }
  ],
  "trailerV2": null,
  "visualIdentity": {
    "sixteenByNineCoverImage": null,
    "squareCoverImage": {
      "__typename": "VisualIdentityImage",
      "extractedColorSet": {
        "encoreBaseSetTextColor": {
          "alpha": 255,
          "blue": 91,
          "green": 166,
          "red": 255
        },
        "highContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 0,
            "green": 58,
            "red": 137
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 0,
            "green": 23,
            "red": 93
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 146,
            "green": 192,
            "red": 255
          }
        },
        "higherContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 0,
            "green": 25,
            "red": 96
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 40,
            "green": 63,
            "red": 137
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 96,
            "green": 215,
            "red": 30
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 146,
            "green": 192,
            "red": 255
          }
        },
        "minContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 12,
            "green": 122,
            "red": 233
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 0,
            "green": 96,
            "red": 204
          },
          "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
          }
        }
      }
    }
  },
  "popularity": null
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

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

04Notes

`contentCapabilityTrait`, `musicAndTalk` and `popularity` are always null. For the full episode list use the podcast episodes endpoint. An unknown show is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.