Podcast Episodes
tier:standard

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.

get/v1/podcasts/episodes/archive

Request

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

Query parameters

updated_sincestring

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

as_ofstring date-time nullable required

The archive holds every episode change recorded up to this time. null until the archive's first full build completes.

stream_sincestring date-time nullable required

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.

Example response

{
  "months": [
    {
      "days": [
        {
          "date": "2026-09-29"
        }
      ],
      "month": "2026-09"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.