Podcasts
tier:standard

List episodes for a podcast

Returns a paginated list of episodes for a specific podcast, identified by slug (e.g., 'all-in') or ID.

get/v1/podcasts/{id}/episodes

Request

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

Path parameters

idstring required

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

qstring

Filter to episodes whose title contains this text, case-insensitively. Matches the episode TITLE only — to search what is said inside episodes, use /v1/podcasts/episodes/search with podcast_id.

sincestring

Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

untilstring

Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)

published_afterstring

Deprecated alias of since.

published_beforestring

Deprecated alias of until.

transcript_status'any' | 'transcribed' | 'untranscribed' | 'requestable'

Filter by where episodes stand on the way to a transcript. Omitted, the list holds the episodes we have ingested, as it always has. any, untranscribed and requestable also list the podcast's back catalogue — episodes we have discovered in its feed but not transcribed: any lists every discovered episode, untranscribed those without a transcript, requestable back-catalogue episodes whose transcript can be requested. transcribed lists episodes with a transcript.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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