particle_podcast_list_episodes
List episodes across the catalog with rich filters: by podcast, person, company, language, date range, duration, or transcript availability.
By default it lists the episodes we have ingested. Pass transcript_status with podcast_slug to reach the show's back catalogue — older episodes discovered in its feed but not transcribed, marked requestable. Their transcript, segments, speakers and entities do not exist until one is requested.
Use this for episode-level discovery when you only need metadata (title, duration, speakers, counts). For dialogue around a person in any episode, use particle_podcast_find_mentions. For ranked retrieval by topic, use particle_podcast_search_transcripts.
The guest_ filters list episodes by their guests' expertise (codes from particle_expertise_resolve): guest_occupation="cardiologists" with guest_practicing=true lists episodes with a practicing cardiologist as a guest.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Role filter when person_slug or company_slug is set. | |
| limit | No | Episodes per page (1-50, default 10). | |
| cursor | No | Opaque pagination cursor from a previous response. | |
| language | No | 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'. | |
| entity_slug | No | Knowledge-graph entity slug from particle_entity_resolve for the long tail that isn't a person or company — places, organizations, events, products, concepts (e.g. 'germany'). Use person_slug for people and company_slug for companies. | |
| guest_field | No | Only episodes with a guest listed under this ANZSRC 2020 field of research: a code, slug or title from particle_expertise_resolve (e.g. 'banking-finance-and-investment'). | |
| person_slug | No | Person slug or encoded person ID from particle_person_resolve, particle_entity_resolve, or the guest tools (e.g. 'sam-altman'). Episodes featuring or mentioning the person. | |
| company_slug | No | Company slug, domain, or ID. Resolves to the linked entity. | |
| max_duration | No | Maximum episode duration in seconds. | |
| min_duration | No | Minimum episode duration in seconds. | |
| podcast_slug | No | Podcast slug, internal ID, or numeric iTunes ID. Restrict to one podcast. A particle.pro or Radar show link also works. | |
| output_format | No | Output serialization. 'markdown' (default) returns the LLM-facing rendering. 'json' returns the structured payload as JSON text — use only for programmatic chaining where exact field extraction matters; the JSON shape is larger and noisier for an LLM to read. | |
| guest_in_field | No | Only episodes with a guest speaking within their own field (the guest the other guest_ filters select, when given). | |
| guest_standing | No | Only episodes with a guest whose standing is recognized this way: 'established' (conferred by others), 'self_described', or 'unverified'. | |
| has_transcript | No | Only include episodes with a completed transcript. Superseded by transcript_status=transcribed; do not pass both. | |
| guest_seniority | No | Only episodes with a guest at this seniority or above. | |
| published_after | No | ISO 8601 date or date-time. | |
| guest_occupation | No | Only episodes with a guest listed under this occupation: a SOC 2018 or ISCO-08 code, slug or title from particle_expertise_resolve (e.g. 'cardiologists' or '29-1212'). | |
| guest_practicing | No | Only episodes with a guest who still works in guest_occupation, which must be a detailed SOC 2018 occupation (e.g. '29-1212'). | |
| published_before | No | ISO 8601 date or date-time. | |
| transcript_status | No | Filter by where episodes stand on the way to a transcript. Omitted lists the episodes we have ingested. any, untranscribed and requestable also list the podcast's back catalogue — episodes discovered in its feed but not transcribed — and require podcast_slug: 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. |