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.
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
Results per page
Opaque pagination cursor from previous response
Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID
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 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 slug (e.g., 'nvidia'), domain (e.g., 'nvidia.com'), or ID. Resolves to the company's linked entity.
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.
Only episodes published after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)
Only episodes published before this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z)
Deprecated alias of since.
Deprecated alias of until.
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'.
Only episodes with completed transcripts
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.
Only episodes that have reached the terminal ingestion milestone (the highest stage exposed by the episode firehose)
Minimum episode duration in seconds
Maximum episode duration in seconds
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.
Only episodes with a guest listed under this ANZSRC 2020 field of research (code, slug, or title).
Only episodes with a guest whose standing is recognized this way.
Only episodes with a guest at this seniority or above.
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.
Only episodes with a guest who still works in guest_occupation, a SOC 2018 occupation or group.
Only episodes with a guest speaking within their field (the guest the other guest_ filters select, when given).
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.