particle_podcast_list_episodes

Filter-driven episode discovery across the catalog — by podcast, person, company, guests’ expertise, language, date range, duration, or transcript availability.

List episodes across the catalog with rich filters: by podcast, person, company, guests’ expertise, 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. They have no transcript, segments, speakers or entities.

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, with codes from particle_expertise_resolve: guest_occupation="cardiologists" with guest_practicing=true lists episodes with a practicing cardiologist as a guest.

Inputs

Field	Type	Required	Default	Description
podcast_slug	string	no	—	Podcast slug, internal ID, or numeric iTunes ID. Restrict to one podcast.
person_slug	string	no	—	Person slug from particle_person_resolve or particle_entity_resolve (e.g. "sam-altman"). Episodes featuring or mentioning the person. Also accepts a bare entity slug for non-person entities like places.
company_slug	string	no	—	Company slug, domain, or ID. Resolves to the linked entity.
role	string	no	—	Role filter when person_slug or company_slug is set. One of: guest, host, panelist, correspondent, mention.
published_after	string	no	—	ISO 8601 date or date-time.
published_before	string	no	—	ISO 8601 date or date-time.
language	string	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.
has_transcript	boolean	no	false	When true, return only episodes with a completed transcript. false or omitted means no transcript filter. Superseded by transcript_status="transcribed"; don’t pass both.
transcript_status	string	no	—	One of any, transcribed, untranscribed, requestable. Omitted lists the episodes we have ingested. any lists every discovered episode, untranscribed those without a transcript, requestable back-catalogue episodes only; these three include the back catalogue and require podcast_slug.
min_duration	integer (≥0)	no	—	Minimum episode duration in seconds.
max_duration	integer (≥0)	no	—	Maximum episode duration in seconds.
guest_occupation	string	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_field	string	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").
guest_standing	string	no	—	Only episodes with a guest whose standing is recognized this way: established (conferred by others), self_described, or unverified.
guest_seniority	string	no	—	Only episodes with a guest at this seniority or above: professional, senior, or distinguished.
guest_capacity	string	no	—	Only episodes with a guest who knows their field in this capacity: researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, or layperson. particle_expertise_resolve names the capacity an everyday word means (founders is executive_founder).
guest_practicing	boolean	no	false	Only episodes with a guest who still works in guest_occupation, which must be a detailed SOC 2018 occupation (e.g. "29-1212").
guest_in_field	boolean	no	false	Only episodes with a guest speaking within their own field (the guest the other guest_ filters select, when given).
limit	integer (1–50)	no	10	Episodes per page.
cursor	string	no	—	Opaque pagination cursor.

All guest_ filters describe the same guest, so guest_occupation="cardiologists" with guest_practicing=true keeps episodes where one guest is a practicing cardiologist. A broad code covers everything below it. A word no occupation names may name a field or a capacity instead, and filters by it: guest_occupation="oncologists" is field 3211, guest_occupation="founders" is guest_capacity="executive_founder". An occupation or field that names nothing returns unresolved_reference with the closest codes as did-you-mean suggestions; guest_practicing without a detailed SOC 2018 guest_occupation returns validation_error.

Output

A markdown document with ## Episodes (N) and one ### Episode title section per episode. Each section carries bulleted KV rows: - **Podcast:**, - **Published:**, - **Episode slug:**, - **Duration:**, - **Transcript:** (only for an episode that is not transcribed: processing, requestable or unavailable, with what that means), - **Counts:** (segments / clips / entities), and - **Speakers:**. The Speakers row is a comma-separated list with up to 6 names; entries with linked entities render as Name (entity_slug). When more pages exist, a horizontal rule and a **Cursor:** <value> line are appended; pass that value back as cursor to fetch the next page.

Sample (podcast_slug="6-minute-english", limit=2):

## Episodes (2)

### Should we eat ultra-processed food?

- **Podcast:** 6 Minute English
- **Published:** 2026-04-30
- **Episode slug:** should-we-eat-ultra-processed-food
- **Duration:** 402s
- **Counts:** 12 segments, 0 clips, 5 entities
- **Speakers:** Hannah Gelbart (hannah-gelbart), Pippa, speaker_2, speaker_3, Phil, Annabel Rackham (annabel-rackham)

### Why are we all so stressed?

- **Podcast:** 6 Minute English
- **Published:** 2026-04-23
- **Episode slug:** why-are-we-all-so-stressed
- **Duration:** 402s
- **Counts:** 9 segments, 0 clips, 4 entities
- **Speakers:** Iqra Farooq, Neil, Becca, Claudia Hammond (claudia-hammond)
---

**Cursor:** r.4gfFC6

The string after - **Episode slug:** is what you pass back as episode_slug to particle_podcast_get_episode or particle_podcast_find_mentions.

Example

Agent calls: particle_podcast_list_episodes {
  "person_slug": "marc-andreessen",
  "role": "guest",
  "published_after": "2025-01-01",
  "has_transcript": true,
  "limit": 20
}

Episodes with an established economist as a guest since September:

Agent calls: particle_podcast_list_episodes {
  "guest_occupation": "economists",
  "guest_standing": "established",
  "published_after": "2026-09-01"
}

Related

• REST equivalent: GET /v1/podcasts/episodes.
• To see how each guest on a returned episode reads, call particle_podcast_get_episode with include: ["guest_expertise"]. The REST guest filters are documented under episodes with expert guests.
• For per-episode dialogue, drill into particle_podcast_get_episode or particle_podcast_find_mentions with the returned episode_slug.