curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive/stream?period=2026-09"[
{
"data": {
"episodes": 123,
"period": "<string>"
},
"event": "complete",
"id": 123,
"retry": 123
}
]{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Replay the episode archive
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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive/stream?period=2026-09"[
{
"data": {
"episodes": 123,
"period": "<string>"
},
"event": "complete",
"id": 123,
"retry": 123
}
]{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
A month (YYYY-MM) or a day (YYYY-MM-DD), by UTC publication date.
^\d{4}-\d{2}(-\d{2})?$"2026-09"
Heavy relations to keep in each episode. Defaults to all of them.
transcript, segments, clips, all 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.
Was this page helpful?