# Podchaser Episodes API Documentation

<p>List public episodes of a podcast by the numeric id returned by search. Each episode holds its id, title, ISO 8601 air date, guid, audio URL, episode number, length and transcript counts. Page with limit and offset and follow has_more. The upstream total is a cap, not an exact count. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/podchaser-api/podchaser_episodes](https://scrappa.co/docs/podchaser-api/podchaser_episodes)
- **API group:** Podchaser API
- **Endpoint:** `GET https://scrappa.co/api/podchaser/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 podcast id from search. |
| `limit` | integer | No | Episodes to return, 1 to 100, default 25. |
| `offset` | integer | No | Episode offset. |

## Example response

```json
{
    "data": {
        "results": [
            {
                "id": 111,
                "title": "Episode 1",
                "length": 1800,
                "air_date": "2026-01-01T00:00:00+00:00",
                "audio_url": "https://example.com/e1.mp3",
                "episode_number": 1
            }
        ],
        "pagination": {
            "limit": 25,
            "total": 10000,
            "offset": 0,
            "has_more": true,
            "returned": 1,
            "total_is_cap": true
        },
        "podcast_id": "243479"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "episodes"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. 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)
