# Apple Podcasts Episodes API Documentation

<p>List public episodes of a show by the collection id returned by search. The response holds the show record and the episode rows in one call, with episode URL, play URL and ISO 8601 release dates. An unknown id is a free 404. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_episodes](https://scrappa.co/docs/apple-podcasts-api/apple_podcasts_episodes)
- **API group:** Apple Podcasts API
- **Endpoint:** `GET https://scrappa.co/api/apple-podcasts/episodes`

## 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 | Numeric collection id from search. |
| `country` | string | No | Storefront: us or de, default us. |
| `limit` | integer | No | Episodes to return, 1 to 200, default 25. |

## Example response

```json
{
    "data": {
        "show": {
            "collectionId": 1200361736
        },
        "country": "US",
        "episodes": [
            {
                "trackName": "Episode 1",
                "episodeUrl": "https://example.com/e1.mp3",
                "releaseDate": "2026-01-01T00:00:00+00:00"
            }
        ],
        "episode_count": 1
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "episodes"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No show has this id. Not billed. |

## 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)
