Get episode embed code

Returns a paste-ready <particle-podcast-clip> HTML snippet for an existing clip or a custom timestamp range within an episode. Either clip_id or start (with optional end) must be supplied; the two modes are mutually exclusive.

For slices: when end is omitted, it defaults to start + 120 seconds. The embed widget caps slice length at 120 seconds, so any end value beyond start + 120s is silently clamped to start + 120s. End is also clamped to the episode duration. The actual range used is encoded in the returned script_url.

get/v1/embed/episodes/{episode_id}/code

Request

Base URL: https://api.particle.pro
URL: https://api.particle.pro/v1/embed/episodes/{episode_id}/code
Auth: none required

Path parameters

episode_idstring required

Episode slug or ID

Query parameters

clip_idstring

Clip ID. Mutually exclusive with start/end.

startnumber double

Slice start in seconds. Mutually exclusive with clip_id.

endnumber double

Slice end in seconds. Optional: when omitted, defaults to start + 120s. The widget caps slices at 120s, so end values further than 120s past start are silently clamped to start + 120s.

theme'light' | 'dark' | 'color-light' | 'color-dark'

Widget theme

size'regular' | 'compact'

Widget size

Response

embed_htmlstring required

Full <particle-podcast-clip> HTML snippet ready to paste

script_urlstring required

Inner widget script URL (the <script src> value)

variant'clip' | 'episode-clip' required

Which embed variant was generated

Changes

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