Skip to main content

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.

Return a bundled overview of one podcast episode: title, podcast, speakers (with entity slugs), top mentioned entities, topics, and segment/clip counts. By default the response is lean — counts plus the top mentioned entities. Set include_full_segments=true for the structural outline with timestamps, include_full_entities=true for the complete entity list, or include_transcript=true for the dialogue transcript (optionally filtered by speaker or time range). For “every line about X in this episode” use podcasts/get_entity_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.
include_transcriptbooleannofalseInclude the dialogue transcript. Off by default — large for long episodes.
transcript_formatstringnotextTranscript format when include_transcript=true. 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.
include_full_segmentsbooleannofalseInclude the full segment list with start/end timestamps. The lean overview returns only counts.
include_full_entitiesbooleannofalseInclude all mentioned entities ranked by salience. The lean overview returns only the top 20.

​
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_full_entities=true.
  • ### Topics — bullets, one topic per line.
  • ### Segments — only when include_full_segments=true. Bullets formatted #N TYPE — Title @ Xs–Ys.
  • ### Transcript (<format>) — only when include_transcript=true. 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_full_segments=true, 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
- 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: podcasts/get_episode {
  "episode_slug": "whcd-shooting-aftermath-musk-and-altman-face-off",
  "include_full_segments": true,
  "include_transcript": true,
  "transcript_format": "dialogue",
  "transcript_speaker": "kara-swisher"
}