> ## 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_list_clips

> Browse AI-extracted highlight clips ranked by engagement potential, or pull one clip's detail and transcript.

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`](/mcp/tools/podcasts/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`](/mcp/tools/podcasts/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

```text theme={"dark"}
Agent calls: particle_podcast_list_clips {
  "podcast_slug": "all-in",
  "type": "CONTROVERSIAL",
  "min_engagement": 70
}
```

## Related

* REST equivalents: [`GET /v1/podcasts/clips`](/podcasts/clips), [`GET /v1/podcasts/clips/{id}`](/podcasts/clips), [`GET /v1/podcasts/clips/{id}/transcript`](/podcasts/transcripts).
* Embed a clip on a web page with the [embed endpoints](/podcasts/embeds).