Skip to main content
GET
/
v1
/
embed
/
episodes
/
{episode_id}
/
code
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/embed/episodes/{episode_id}/code?theme=light&size=regular"
{
  "embed_html": "<string>",
  "script_url": "<string>",
  "variant": "clip"
}

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.

Authorizations

​
X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

​
episode_id
string
required

Episode slug or base62 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

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