Podcast Clips
tier:standard

List clips

Returns AI-extracted highlight clips across podcast episodes, ranked by engagement potential. Filter by podcast, episode, clip type, minimum engagement score, or speaker (the person talking in the clip). For text-based clip discovery (semantic, keyword, or entity mention search), use GET /v1/podcasts/episodes/search — matching clips are embedded inside each search result alongside the parent segment and dialogue.

get/v1/podcasts/clips

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/clips
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

episode_idstring

Filter to a specific episode by slug or ID

podcast_idstring

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

speakerstring

Speaker filter: person slug (e.g., 'sam-altman'), knowledge-graph entity slug for the same person, or ID. Returns only clips whose primary speaker is this person.

type'SPICY' | 'CONTROVERSIAL' | 'EMOTIONAL' | 'FUNNY' | 'SHOCKING' | 'INSIGHTFUL' | 'INFORMATIVE' | 'EDUCATIONAL' | 'PHILOSOPHICAL' | 'AHA_MOMENT' | 'NOTABLE_LINE' | 'BEST_STORY' | 'DEBATE_DISAGREEMENT'

Clip type filter, case-insensitive: SPICY, CONTROVERSIAL, EMOTIONAL, FUNNY, SHOCKING, INSIGHTFUL, INFORMATIVE, EDUCATIONAL, PHILOSOPHICAL, AHA_MOMENT, NOTABLE_LINE, BEST_STORY, DEBATE_DISAGREEMENT

min_engagementinteger

Minimum engagement potential score (integer, 0 to 100). Values above 70 are typical for a strong clip.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.