# Spotify Podcast Episode

Get a Spotify podcast episode with duration, release date, description and show reference.

- **Documentation:** [https://scrappa.co/docs/spotify-api/spotify_episode](https://scrappa.co/docs/spotify-api/spotify_episode)
- **API group:** Spotify API
- **Endpoint:** `GET https://scrappa.co/api/spotify/episode`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | <p>Spotify episode id or full spotify:episode: URI.</p> |

## Example response

```json
{
    "id": "7makk4oTQel546B0PZlDM5",
    "uri": "spotify:episode:7makk4oTQel546B0PZlDM5",
    "name": "My Path to Spotify: Women in Engineering ",
    "type": "PODCAST_EPISODE",
    "audio": {
        "items": [
            {
                "url": "https://p.scdn.co/mp3-preview/8d79ac4fa0e9a3a1029054ff1e4d52b77e7336c0"
            },
            {
                "url": "https://p.scdn.co/mp3-preview/66c297275450e05326c39fd6c4ae6affaec378e1"
            },
            {
                "url": "https://p.scdn.co/mp3-preview/99a003f9b1a7aff8c0ed242983ec3a392d541519"
            },
            {
                "url": "https://p.scdn.co/mp3-preview/7fca3acaedcce9db5559dfb1cf3e788b7589f043"
            },
            {
                "url": "https://p.scdn.co/mp3-preview/eef1cb5882070688eb93d628596dd1fa8e07a941"
            },
            {
                "url": "https://p.scdn.co/mp3-preview/582e92802fdfdffa874f6bfcbc004ccedf8887c4"
            }
        ]
    },
    "duration": {
        "totalMilliseconds": 2152056
    },
    "podcastV2": {
        "data": {
            "uri": "spotify:show:2bzjLBEWRldARaf1IytFFS",
            "name": "Life at Spotify: The Podcast",
            "coverArt": {
                "sources": [
                    {
                        "url": "https://i.scdn.co/image/ab6765630000f68d234dcba12b4d31ce8ae7ed87",
                        "width": 64,
                        "height": 64
                    },
                    {
                        "url": "https://i.scdn.co/image/ab67656300005f1f234dcba12b4d31ce8ae7ed87",
                        "width": 300,
                        "height": 300
                    },
                    {
                        "url": "https://i.scdn.co/image/ab6765630000ba8a234dcba12b4d31ce8ae7ed87",
                        "width": 640,
                        "height": 640
                    }
                ]
            },
            "showTypes": [],
            "trailerV2": null,
            "__typename": "Podcast",
            "accessInfo": null
        }
    },
    "__typename": "Episode",
    "description": "Neither of these amazing women started out dreaming of being engineers, yet against all odds, here they are! Join Tilo as she chats with Adele, Staff Engineer i",
    "releaseDate": {
        "isoString": "2021-07-30T13:13:00Z",
        "precision": "MINUTE"
    },
    "search_parameters": {
        "id": "7makk4oTQel546B0PZlDM5",
        "engine": "spotify_episode"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No Spotify data exists for the requested id or chart key. Failed requests are never charged. |
| 422 | Validation Error | A required parameter is missing or invalid. See the errors object for the offending field. |
| 503 | Upstream Unavailable | Spotify could not be reached or returned an unusable response. This is a failed request and is never charged; it is safe to retry. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)