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

cURL

cURL

curl "https://api.particle.pro/v1/embed/episodes/{episode_id}/code?theme=light&size=regular"

200

{
  "embed_html": "<string>",
  "script_url": "<string>"
}

Path Parameters

episode_id · string · required

Episode slug or ID

Query Parameters

clip_id · string

Clip ID. Mutually exclusive with start/end.

start · number<double>

Slice start in seconds. Mutually exclusive with clip_id.

Required range: x >= 0

end · number<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.

Required range: x >= 0

theme · enum<string> · default: light

Widget theme

Available options: light, dark, color-light, color-dark

size · enum<string> · default: regular

Widget size

Available options: regular, compact

Response

200

application/json

OK

embed_html · string · required

Full HTML snippet ready to paste

script_url · string · required

Inner widget script URL (the

variant · enum<string> · required

Which embed variant was generated

Available options: clip, episode-clip