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.

List engagement-ranked highlight clips across the catalog. Filter by episode, podcast, clip type, or engagement score. Each clip includes a direct MP3 audio URL and the parent episode/podcast slugs. For clip discovery driven by what is said (semantic or keyword), use podcasts/search_dialogue instead — overlapping clips come back inside each ranked match.

​
Inputs

FieldTypeRequiredDefaultDescription
episode_slugstringno—Filter to a specific episode by slug or ID.
podcast_slugstringno—Filter to a specific podcast by slug or ID.
clip_typestringno—One of: SPICY, CONTROVERSIAL, EMOTIONAL, FUNNY, SHOCKING, INSIGHTFUL, INFORMATIVE, EDUCATIONAL, PHILOSOPHICAL, AHA_MOMENT, NOTABLE_LINE, BEST_STORY, DEBATE_DISAGREEMENT.
min_engagementinteger (0–100)no—Minimum engagement score. Values above 70 are typical for a strong clip.
limitinteger (1–50)no10Clips per page.
cursorstringno—Opaque pagination cursor.

​
Output

A markdown document with ## Clips (N) and one ### Clip title section per clip. Each section carries **Type:**, **Engagement:** (0–100), **Duration:**, **Speaker:** (with entity slug appended as Name (entity_slug) when linked), **Episode:**, **Podcast:**, and **Audio:** (direct MP3 URL) lines, then a paragraph with the clip’s intro statement (ready-to-share copy). Older clips paginate with cursor=<value>. Sample (podcast_slug="6-minute-english", limit=2): 
## Clips (2)

### Debunking Wellness Quick-Fire

**Type:** INSIGHTFUL
**Engagement:** 78
**Duration:** 36s
**Speaker:** Georgie
**Episode:** Can we boost the immune system?
**Podcast:** 6 Minute English
**Audio:** https://storage.googleapis.com/uploads.mongoosehq.com/podcast/episode/b1f22a91-…/clip/audio/e8342676-….mp3
Let's test trendy immune boosters fast.

### Do Saunas Extend Life?

**Type:** INFORMATIVE
**Engagement:** 78
**Duration:** 62s
**Speaker:** Damian Bailey
**Episode:** Are saunas good for you?
**Podcast:** 6 Minute English
**Audio:** https://storage.googleapis.com/uploads.mongoosehq.com/podcast/episode/ef983ead-…/clip/audio/dfe2db33-….mp3
So, are sauna benefits actually real?
The URL after **Audio:** is the direct MP3 — usable as an <audio> source or for downstream transcription.

​
Example

Agent calls: podcasts/list_clips {
  "podcast_slug": "all-in",
  "clip_type": "DEBATE_DISAGREEMENT",
  "min_engagement": 80,
  "limit": 5
}