Podcast Episodes
tier:standard

List episodes

Returns a paginated list of podcast episodes across all podcasts. Filter by podcast slug or ID, entity slug or ID, company slug or domain, date range, and language.

get/v1/podcasts/episodes

Request

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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

podcast_idstring

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

entity_idstring

Entity or person slug (e.g., 'elon-musk', 'openai') or ID. Returns episodes featuring this entity as a speaker or mentioned entity. A person with no linked entity matches the episodes they speak in. A slug that names both an entity and a person means the entity; pass the person's ID to filter by the person.

person_idstring

Person slug (e.g., 'dick-costolo'), knowledge-graph entity slug for the same person, or ID. Returns episodes featuring this person as a speaker — works even when the speaker has no knowledge-graph entity linked. When the value itself matches a knowledge-graph entity slug (corroborated to the same person), the default and 'mention' roles also include episodes that merely mention the person, matching entity_id semantics; pass a speaker role (guest, host, panelist, correspondent) for speaker-only results.

company_idstring

Company slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.

role'guest' | 'host' | 'panelist' | 'correspondent' | 'speaker' | 'mention'

Entity role filter. Constrains which episodes match the entity_id, person_id, or company_id. 'speaker' matches any speaking role (host, co-host, guest, panelist, correspondent) without including mention-only episodes.

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.

languagestring

Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.

Example:fr
has_transcriptboolean

Only episodes with completed transcripts

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 — so they require podcast_id: 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, like has_transcript, which it replaces. Back-catalogue episodes carry no speakers, entities or topics, so entity_id, person_id, company_id and fully_ingested leave them out.

fully_ingestedboolean

Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)

min_durationinteger

Minimum episode duration in seconds

max_durationinteger

Maximum episode duration in seconds

guest_occupationstring

Only episodes with a guest listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is guest_capacity=executive_founder.

guest_fieldstring

Only episodes with a guest listed under this ANZSRC 2020 field of research (code, slug, or title).

guest_standing'established' | 'self_described' | 'unverified'

Only episodes with a guest whose standing is recognized this way.

guest_seniority'professional' | 'senior' | 'distinguished'

Only episodes with a guest at this seniority or above.

guest_capacity'researcher' | 'licensed_professional' | 'practitioner' | 'executive_founder' | 'public_official' | 'journalist_analyst' | 'creator_entertainer' | 'athlete_coach' | 'clergy' | 'firsthand' | 'layperson'

Only episodes with a guest who knows their field in this capacity, such as executive_founder for founders. It narrows the other filters; an everyday word for a capacity passed as guest_occupation (founders, politicians) lands here too.

guest_practicingboolean

Only episodes with a guest who still works in guest_occupation, a SOC 2018 occupation or group.

guest_in_fieldboolean

Only episodes with a guest speaking within their field (the guest the other guest_ filters select, when given).

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.