> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_podcast_get_episode

> Bundled overview of one episode — speakers, top entities, segment/clip counts, and optional transcript, segments, entities, clips, and topics.

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`](/mcp/tools/podcasts/podcast-search-transcripts) matches.

For "every line about X in this episode" use [`particle_podcast_find_mentions`](/mcp/tools/podcasts/podcast-find-mentions) with `episode_slug` instead — that returns the dialogue around each mention with `is_mention` flags.

## Inputs

| Field                | Type           | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | -------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `episode_slug`       | string         | yes      | —       | Episode slug or canonical ID.                                                                                                                                                                                                                                                                                                                                                          |
| `include`            | array of enums | no       | `[]`    | 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_format`  | string         | no       | `text`  | Transcript format for `include: ["transcript"]`. One of `dialogue`, `text`, `srt`.                                                                                                                                                                                                                                                                                                     |
| `transcript_speaker` | string         | no       | —       | Filter the transcript to one speaker (name or entity slug).                                                                                                                                                                                                                                                                                                                            |
| `transcript_start`   | number         | no       | —       | Transcript start clip in seconds.                                                                                                                                                                                                                                                                                                                                                      |
| `transcript_end`     | number         | no       | —       | Transcript end clip in seconds.                                                                                                                                                                                                                                                                                                                                                        |

<Note>
  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.
</Note>

## 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`](/mcp/tools/topics/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):

```markdown theme={"dark"}
## 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

```text theme={"dark"}
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:

```text theme={"dark"}
Agent calls: particle_podcast_get_episode {
  "episode_slug": "all-in-200",
  "include": ["clips"]
}
```

## Related

* REST equivalents: [`GET /v1/podcasts/episodes/{id}`](/podcasts/episodes), [`/transcript`](/podcasts/transcripts), [`/segments`](/podcasts/segments-and-clips), [`/entities`](/podcasts/episodes#entities).
* For dialogue around a specific entity in this episode, use [`particle_podcast_find_mentions`](/mcp/tools/podcasts/podcast-find-mentions) with `episode_slug`.
* For ranked dialogue across the catalog, use [`particle_podcast_search_transcripts`](/mcp/tools/podcasts/podcast-search-transcripts).