curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive"{
"as_of": "2023-11-07T05:31:56Z",
"months": [
{
"bytes": 123,
"days": [
{
"bytes": 123,
"date": "2026-09-29",
"episodes": 123,
"updated_at": "2023-11-07T05:31:56Z",
"version": "<string>"
}
],
"episodes": 123,
"month": "2026-09",
"updated_at": "2023-11-07T05:31:56Z",
"version": "<string>"
}
],
"stream_since": "2023-11-07T05:31:56Z"
}{
"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"
}List the episode archive
Lists the months and days of the podcast episode archive, the complete history of transcribed episodes delivered as bulk files. Available by arrangement. Download a month or a day with GET /v1/podcasts/episodes/archive/download, then follow GET /v1/podcasts/episodes/stream from stream_since. To keep a copy current, list again with updated_since set to your previous as_of and download the days it returns.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/archive"{
"as_of": "2023-11-07T05:31:56Z",
"months": [
{
"bytes": 123,
"days": [
{
"bytes": 123,
"date": "2026-09-29",
"episodes": 123,
"updated_at": "2023-11-07T05:31:56Z",
"version": "<string>"
}
],
"episodes": 123,
"month": "2026-09",
"updated_at": "2023-11-07T05:31:56Z",
"version": "<string>"
}
],
"stream_since": "2023-11-07T05:31:56Z"
}{
"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
Only list the days whose content changed after this time, to re-sync a copy you already hold. Pass the as_of of your previous sync. A listed day with 0 episodes no longer has any; remove your copy.
Response
OK
The archive holds every episode change recorded up to this time. null until the archive's first full build completes.
Months with archived episodes, oldest first.
Show child attributes
Show child attributes
Pass this as since= to GET /v1/podcasts/episodes/stream to pick up where the archive leaves off. Some episodes will arrive twice; deduplicate on the episode id. null until the archive's first full build completes.
Was this page helpful?