---
title: "Replay the episode archive"
method: GET
path: "/v1/podcasts/episodes/archive/stream"
tags: ["Podcast Episodes", "tier:standard"]
---

# Replay the episode archive

`GET /v1/podcasts/episodes/archive/stream`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/podcasts/episodes/archive/stream`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Replays a month or a day of the podcast episode archive as Server-Sent Events, so a consumer of `GET /v1/podcasts/episodes/stream` can load history through the same code. Each `episode` event carries the episode exactly as the stream delivers it, in publication order, and a `complete` event closes a full replay. Resume a dropped connection with `cursor`. **Available by arrangement.** For bulk loading, the download endpoint is several times faster.

## Query parameters

- `period` string, required: A month (YYYY-MM) or a day (YYYY-MM-DD), by UTC publication date.
- `include` string[], nullable: Heavy relations to keep in each episode. Defaults to all of them.
- `cursor` string: Resume after this event: pass the cursor of the last episode you processed. If the period was rebuilt since, the replay answers with an error event; start it again without a cursor.

## Response `200`

OK

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)
