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"
}Podcast Episodes
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.
GET
/
v1
/
podcasts
/
episodes
/
archive
/
stream
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"
}Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.
Authorizations
ApiKeyHeaderBearerAuth
Query Parameters
Was this page helpful?