particle_podcast_list_clips

Browse AI-extracted highlight clips across the catalog, ranked by engagement potential — the shareable moments. Filter by podcast, episode, clip type, or minimum engagement score. Pass clip_id for one clip’s full detail (description, social-hook intro, speaker, audio URL), plus include: ["transcript"] for its dialogue. For text-based clip discovery — finding clips about a topic or entity — use particle_podcast_search_transcripts instead: matching clips arrive inline on each search result. A known episode’s full clip list also comes from particle_podcast_get_episode with include: ["clips"].

Inputs

Field	Type	Required	Default	Description
`clip_id`	string	no	—	Return one clip’s full detail instead of a listing. Clip IDs come from this tool, `particle_podcast_get_episode` with `include=clips`, and search-result overlapping clips.
`include`	array of enums	no	`[]`	With `clip_id` only: `transcript` attaches the clip’s dialogue transcript.
`podcast_slug`	string	no	—	Restrict the listing to one podcast (slug, internal ID, or numeric iTunes ID).
`episode_slug`	string	no	—	Restrict the listing to one episode (slug or ID).
`type`	string	no	—	Clip type filter: `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 potential score. Above 70 is typical for a strong clip.
`limit`	integer (1–50)	no	10	Clips per page.
`cursor`	string	no	—	Opaque pagination cursor.

Output

Listing mode: ## Highlight clips (N) with one bullet per clip — **Title** (TYPE, score N) — Episode Title on Podcast Title (episode-slug) @ 100s–160s — clip ID: <id>. Episode slugs feed the episode tools; clip IDs feed the clip_id detail path. When more pages exist, a horizontal rule and a **Cursor:** line are appended. Detail mode (clip_id set): the clip title as an H2 with **Clip ID:**, **Type:**, **Engagement score:**, **Speaker:**, **Episode:**, **Span:**, and **Audio:** rows, the description paragraph, the **Social hook:** line, and — with include=["transcript"] — a ### Transcript section of **Speaker:** text dialogue lines.

Example

Agent calls: particle_podcast_list_clips {
  "podcast_slug": "all-in",
  "type": "CONTROVERSIAL",
  "min_engagement": 70
}

REST equivalents: GET /v1/podcasts/clips, GET /v1/podcasts/clips/{id}, GET /v1/podcasts/clips/{id}/transcript.
Embed a clip on a web page with the embed endpoints.

Get started

Tools

particle_podcast_list_clips

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related