---
title: "Download the show archive"
method: GET
path: "/v1/podcasts/archive/download"
tags: ["Podcasts", "tier:standard"]
---

# Download the show archive

`GET /v1/podcasts/archive/download`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/podcasts/archive/download`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Downloads every live podcast as gzip-compressed JSON Lines, one show per line. Each line is the podcast exactly as `GET /v1/podcasts/{id}` returns it with every section (`include=related,recommended_guests,recommended_sponsors,coverage`), plus its `external_links` with their attributes, as `GET /v1/podcasts/{id}/external-links` returns them. **Available by arrangement**, with the episode archive. The file is rebuilt twice a day; its values, popularity and audience metrics among them, are as of the current build, which `Last-Modified` dates. Replace your copy rather than merging into it: a show missing from a newer download has been removed. The download can be resumed with a Range request, and `If-None-Match` with its `ETag` returns 304 until the next build.

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