SpotifyPodcasts API endpoint
Returns metadata for one Spotify podcast show by `uri` (default `spotify:show:1QQJ7FElLE0K6CIfZNCxU4`): name, publisher, description, media type, explicit flag, `totalEpisodes`, cover images and Spotify URL. The two `include_` flags request extra content capability and content rating fields when Spotify supplies them.
/spotify-podcasts/show| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| url | 3 | i.scdn.co |
| width | 3 | |
| height | 3 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| uri | string | No | Spotify show URI | spotify:show:1QQJ7FElLE0K6CIfZNCxU4 | |
| include_content_capability_trait | boolean | No | Include content capability trait | false | |
| include_episode_content_ratings_v2 | boolean | No | Include Spotify episode content ratings v2 | false | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/spotify-podcasts/show?include_content_capability_trait=true&include_episode_content_ratings_v2=true" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"uri": "spotify:show:1QQJ7FElLE0K6CIfZNCxU4",
"type": "Podcast",
"name": "Example Show",
"publisher": "Example Publisher",
"description": "A normalized show description.",
"mediaType": "AUDIO",
"totalEpisodes": 42,
"externalUrl": "https://open.spotify.com/show/1QQJ7FElLE0K6CIfZNCxU4"
}
}Request schema
No body schema
Response schema
#/definitions/spotify.showResponseDoc
| 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.ShowMetadataResponse | No | ||||
| data.description | string | No | Tales from the Stinky Dragon is an actual-play comedy podcast. | |||
| data.externalUrl | string | No | https://open.spotify.com/show/1QQJ7FElLE0K6CIfZNCxU4 | |||
| data.imageUrl | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | |||
| data.images | array | No | ||||
| data.images[].height | integer | No | 640 | Image height in pixels. | ||
| data.images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.images[].width | integer | No | 640 | Image width in pixels. | ||
| data.isExplicit | boolean | No | false | |||
| data.mediaType | string | No | MIXED | |||
| data.meta | spotify.ShowMetadataMeta | No | ||||
| data.meta.appVersion | string | No | 1.2.90.403.gf901f20f | |||
| data.meta.fetchedAt | string | No | 2026-05-13T20:41:13Z | |||
| data.meta.operationName | string | No | queryShowMetadataV2 | |||
| data.name | string | No | Tales from the Stinky Dragon | |||
| data.publisher | string | No | Stinky Dragon | |||
| data.totalEpisodes | integer | No | 202 | |||
| data.type | string | No | Podcast | |||
| data.uri | string | No | spotify:show:1QQJ7FElLE0K6CIfZNCxU4 | |||
| 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?include_content_capability_trait=true&include_episode_content_ratings_v2=true" \
-H "x-api-key: $CRAWLORA_API_KEY"