---
title: "Download the episode archive"
method: GET
path: "/v1/podcasts/episodes/archive/download"
tags: ["Podcast Episodes", "tier:standard"]
---

# Download the episode archive

`GET /v1/podcasts/episodes/archive/download`

## 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

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.

## Query parameters

- `period` string, required: A month (YYYY-MM) or a day (YYYY-MM-DD), by UTC publication date.
- `include` string[], nullable: 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 `200`

The file.

## Other responses

- `206`: The requested byte range of the file, answering a Range request.
- `304`: Not modified: the If-None-Match tag still matches, or, without one, the file has not changed since If-Modified-Since. No body.
- `416`: The requested range lies outside the file.
- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)