Podcast Clips
tier:standard

Get a clip

Returns a single clip by its unique identifier.

get/v1/podcasts/clips/{id}

Request

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

Path parameters

idstring required

Clip ID

Response

OK

audio_urlstring

Direct audio URL for this clip

descriptionstring

AI-generated clip description

duration_secondsnumber double required

Clip duration

end_secondsnumber double required

End time within the episode

engagement_scorenumber double required

AI-predicted engagement potential (integer, 0 to 100). Values above 70 are typical for a strong clip.

idstring required

Unique identifier

intro_statementstring

AI-generated hook text for social sharing

quotestring

Verbatim transcript line from the clip, at most 140 characters, by the clip's speaker where possible

start_secondsnumber double required

Start time within the episode

titlestring required

AI-generated clip title

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

Clip type

urlstring

Moment link that plays the clip in its episode on Radar: the episode's web_url with ?t= at start_seconds. Cite or share it to link the exact moment. On a clip inside a search match it comes from the match's episode. Omitted when the episode is not known.

Changes

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