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), useDocumentation Index
Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
Use this file to discover all available pages before exploring further.
podcasts/search_dialogue instead — overlapping clips come back inside each ranked match.
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
episode_slug | string | no | — | Filter to a specific episode by slug or ID. |
podcast_slug | string | no | — | Filter to a specific podcast by slug or ID. |
clip_type | string | no | — | One of: SPICY, CONTROVERSIAL, EMOTIONAL, FUNNY, SHOCKING, INSIGHTFUL, INFORMATIVE, EDUCATIONAL, PHILOSOPHICAL, AHA_MOMENT, NOTABLE_LINE, BEST_STORY, DEBATE_DISAGREEMENT. |
min_engagement | integer (0–100) | no | — | Minimum engagement score. Values above 70 are typical for a strong clip. |
limit | integer (1–50) | no | 10 | Clips per page. |
cursor | string | no | — | 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):
**Audio:** is the direct MP3 — usable as an <audio> source or for downstream transcription.
Example
Related
- REST equivalent:
GET /v1/podcasts/clips. - For dialogue-content-driven clip discovery, use
podcasts/search_dialogue—overlapping_clipsis set on each ranked match.