SpotifyPodcasts API endpoint
Lists shows and episodes that Spotify recommends alongside a podcast show given by `uri`. Each recommendation has a type, title, publisher, description, images and Spotify URL, and `meta.count` gives the number returned. The response echoes the show `uri` it was requested for.
/spotify-podcasts/show/recommendationsMCP tool: spotify_podcasts_show_recommendations
Returns related Spotify shows and episodes for a Spotify show URI.
| Field | Filled in, of 9 checked | Values in the sample |
|---|---|---|
| uri | 9 | “spotify:show:15T8pm3JcVIxSGIebmdKDg” and 8 other values |
| type | 9 | Podcast in all 9 |
| title | 9 | “Legends of Avantris” and 8 other values |
| subtitle | 9 | “Avantris Entertainment” and 8 other values |
| publisher | 9 | “Avantris Entertainment” and 8 other values |
| imageUrl | 9 | i.scdn.co |
| images | 9 | median 3 entries |
| externalUrl | 9 | open.spotify.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| uri | string | No | Spotify show URI | spotify:show:1QQJ7FElLE0K6CIfZNCxU4 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/show/recommendations" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"uri": "spotify:show:1QQJ7FElLE0K6CIfZNCxU4",
"recommendations": [
{
"uri": "spotify:show:related",
"type": "Podcast",
"title": "Related Show",
"publisher": "Related Publisher",
"externalUrl": "https://open.spotify.com/show/related"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/spotify.showRecommendationsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | spotify.ShowRecommendationsResponse | No | ||||
| data.meta | object | No | Details about this response. | |||
| data.meta.appVersion | string | No | 1.2.90.403.gf901f20f | Version of the Spotify web player the data was read from. | ||
| data.meta.count | integer | No | 10 | Number of recommendations returned. | ||
| data.meta.fetchedAt | string | No | 2026-05-13T20:41:13Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.meta.operationName | string | No | internalLinkRecommenderShow | Name of the Spotify web player operation that returned the data. | ||
| data.recommendations | array | No | Related shows and episodes Spotify suggests. | |||
| data.recommendations[].description | string | No | The official podcast of comedian Joe Rogan. | Description text of the recommended item. | ||
| data.recommendations[].externalUrl | string | No | https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk | Link to the recommended item on open.spotify.com. | ||
| data.recommendations[].imageUrl | string | No | https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b | URL of the main image for the recommended item. | ||
| data.recommendations[].images | array | No | Images available for the recommended item, with their sizes. | |||
| data.recommendations[].images[].height | integer | No | 640 | Image height in pixels. | ||
| data.recommendations[].images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.recommendations[].images[].width | integer | No | 640 | Image width in pixels. | ||
| data.recommendations[].publisher | string | No | Joe Rogan | Publisher or creator name of the recommended item. | ||
| data.recommendations[].subtitle | string | No | Joe Rogan | Secondary line shown under the title, such as the creator name. | ||
| data.recommendations[].title | string | No | The Joe Rogan Experience | Title of the recommended item as Spotify shows it. | ||
| data.recommendations[].type | string | No | Podcast | Kind of item as Spotify labels it, for example `Podcast`. | ||
| data.recommendations[].uri | string | No | spotify:show:4rOoJ6Egrf8K2IrywzwOMk | Spotify URI of the recommended item. | ||
| data.uri | string | No | spotify:show:1QQJ7FElLE0K6CIfZNCxU4 | Spotify URI of the show the recommendations are for. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 503 | Spotify upstream request failed | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/show/recommendations" \
-H "x-api-key: $CRAWLORA_API_KEY"