curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive/download?period=2026-09""<string>""<string>"{
"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"
}Download the episode archive
Downloads a month or a day of the podcast episode archive as gzip-compressed JSON Lines, one episode per line, ordered by publication time. Each line is the episode exactly as GET /v1/podcasts/episodes/stream delivers it with include=all. Available by arrangement. A day can be resumed with a Range request; a month cannot, so download days when your connection is unreliable. A download is a complete snapshot of its period: replace your copy rather than merging into it. Conditional requests with If-None-Match return 304 when nothing changed.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive/download?period=2026-09""<string>""<string>"{
"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. Narrowing it costs nothing to you but is served more slowly, and a narrowed download cannot be resumed with Range.
transcript, segments, clips, all Response
The file.
The response is of type file.
Was this page helpful?