Skip to main content
Return a bundled overview of one podcast episode: title, podcast, speakers (with entity slugs), top mentioned entities, and segment/clip counts. By default the response is lean — counts plus the top mentioned entities. Request optional sections via include: segments for the structural outline with timestamps, entities for the complete entity list (instead of the top 20), clips for engagement-ranked highlight clips, topics for topic classifications with slugs, or transcript for the dialogue transcript (narrow it by speaker or time range via transcript_speaker / transcript_start / transcript_end — full transcripts are large). This is also where a known episode’s full clip list lives — include: ["clips"]. There is no separate clip-listing tool; relevant clips for a search arrive inline on particle_podcast_search_transcripts matches. For “every line about X in this episode” use particle_podcast_find_mentions with episode_slug instead — that returns the dialogue around each mention with is_mention flags.

​
Inputs

FieldTypeRequiredDefaultDescription
episode_slugstringyes—Episode slug or canonical ID.
includearray of enumsno[]Optional response sections: transcript (bounded dialogue transcript — large for long episodes; narrow with the transcript_* sub-params), segments (structural outline with timestamps), entities (complete mentioned-entity list instead of the top 20), clips (engagement-ranked highlight clips), topics (topic classifications with slugs). Request only what you need.
transcript_formatstringnotextTranscript format for include: ["transcript"]. One of dialogue, text, srt.
transcript_speakerstringno—Filter the transcript to one speaker (name or entity slug).
transcript_startnumberno—Transcript start clip in seconds.
transcript_endnumberno—Transcript end clip in seconds.
The old boolean flags include_transcript, include_full_segments, and include_full_entities are gone — pass the matching value in the include array instead (["transcript"], ["segments"], ["entities"]). The transcript_* sub-parameters are unchanged.

​
Output

A markdown document with the episode title as an H2, then KV lines (**Podcast:** as Title (slug), **Published:**, **Episode slug:**, **Duration:**, **Counts:** summarising segments/clips/entities), then a paragraph description. The following H3 sections appear when the underlying data is present:
  • ### Speakers — bullets of Name (role) (slug appended as — slug: <entity_slug> when linked).
  • ### Top entities — bullets of Name (slug) — salience X.XXX, N occurrences. Capped at 20 unless include contains entities.
  • ### Topics — bullets of Name — slug: <topic_slug>. Only when include contains topics. The slug round-trips into particle_topic_browse and topic_slug filters.
  • ### Segments — only when include contains segments. Bullets formatted #N TYPE — Title @ Xs–Ys.
  • ### Clips — only when include contains clips. Bullets formatted Title (clip-id) — TYPE, engagement N @ Xs–Ys.
  • ### Transcript (<format>) — only when include contains transcript. Body is the raw transcript text/SRT, or for dialogue format a series of **Speaker:** text lines.
Sample (episode_slug="why-are-we-all-so-stressed", include=["segments","topics"], truncated): 
## Why are we all so stressed?

**Podcast:** 6 Minute English (6-minute-english)
**Published:** 2026-04-23
**Episode slug:** why-are-we-all-so-stressed
**Duration:** 402s
**Counts:** 9 segments, 0 clips, 4 entities
Worrying about exams, work or climate change in the news. …

### Speakers

- Neil (HOST)
- Becca (HOST)

### Top entities

- Claudia Hammond (claudia-hammond) — salience 0.875, 15 occurrences
- English (english) — salience 0.375, 11 occurrences

### Topics

- Mental Health — slug: society/mental-health
- Stress Management — slug: society/mental-health/stress-management

### Segments

- #1 INTRO — Show and series introduction @ 0s–41s
- #2 PERSONAL_BANTER — Hosts share what makes them stressed @ 42s–94s
- #3 TOPIC_DISCUSSION — Defining overwhelm and burnout @ 95s–150s

​
Example

Agent calls: particle_podcast_get_episode {
  "episode_slug": "whcd-shooting-aftermath-musk-and-altman-face-off",
  "include": ["segments", "transcript"],
  "transcript_format": "dialogue",
  "transcript_speaker": "kara-swisher"
}
Pulling a known episode’s full highlight-clip list: 
Agent calls: particle_podcast_get_episode {
  "episode_slug": "all-in-200",
  "include": ["clips"]
}