---
title: "Get clip embed"
method: GET
path: "/v1/embed/clips/{id}"
tags: ["Embed", "tier:free"]
---

# Get clip embed

`GET /v1/embed/clips/{id}`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/embed/clips/{id}`
- Auth: none required

Returns a minimal public representation of a clip for embed rendering.

## Path parameters

- `id` string, required: Clip ID

## Response `200`

OK

- ClipEmbed
  - `audio_url` string, required: Direct audio URL
  - `duration_seconds` number, double, required: Clip duration
  - `intro_statement` string: Hook text for the embed card
  - `podcast_artwork_url` string: Podcast cover image URL
  - `podcast_link` string: Apple Podcasts or podcast URL
  - `podcast_name` string: Podcast title
  - `published` string: Episode publish date as short relative string
  - `speaker_name` string: Primary speaker name
  - `speakers` object: Speaker map keyed by speaker_id
  - `story_color_dominant` string: Dominant color hex from the story header image
  - `story_url` string: Link to the story this clip is from
  - `title` string, required: Clip title

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)