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 or If-Modified-Since return 304 when nothing changed, and HEAD returns the headers alone.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/episodes/archive/download
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Query parameters
A month (YYYY-MM) or a day (YYYY-MM-DD), by UTC publication date.
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.
Response
The file.
Changes
No recorded changes to this operation across all 2 revisions of this API.