Skip to main content
GET
/
v1
/
podcasts
/
episodes
/
{id}
Get an episode
curl --request GET \
  --url https://api.particle.pro/v1/podcasts/episodes/{id} \
  --header 'X-API-Key: <api-key>'
{
  "duration_seconds": 123,
  "explicit": true,
  "has_transcript": true,
  "id": "<string>",
  "title": "<string>",
  "audio_url": "<string>",
  "clip_count": 123,
  "description": "<string>",
  "entity_count": 123,
  "episode_number": 123,
  "image_url": "<string>",
  "language": "<string>",
  "podcast": {
    "id": "<string>",
    "title": "<string>",
    "image_url": "<string>",
    "slug": "<string>"
  },
  "published_at": "2023-11-07T05:31:56Z",
  "segment_count": 123,
  "speakers": [
    {
      "name": "<string>",
      "company": {
        "id": "<string>",
        "domain": "<string>",
        "ticker": "<string>"
      },
      "description": "<string>",
      "entity_id": "<string>",
      "entity_slug": "<string>",
      "person": {
        "id": "<string>",
        "company": "<string>",
        "image_url": "<string>",
        "title": "<string>"
      },
      "role": "<string>",
      "speaking_duration_seconds": 123
    }
  ],
  "topics": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "ancestry": "<string>",
      "ancestry_path": "<string>",
      "episode_count": 123
    }
  ],
  "url": "<string>"
}

Authorizations

X-API-Key
string
header
required

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

Path Parameters

id
string
required

Episode ID

Response

OK

duration_seconds
number<double>
required

Episode duration in seconds

explicit
boolean
required

Whether the episode contains explicit content

has_transcript
boolean
required

Whether a transcript is available

id
string
required

Unique identifier

title
string
required

Episode title

audio_url
string

Direct audio stream URL

clip_count
integer<int64>

Number of AI-extracted clips

description
string

Episode description

entity_count
integer<int64>

Number of mentioned entities

episode_number
integer<int64>

Episode number in the series

image_url
string

Episode artwork URL

language
string

ISO 639-1 language code

podcast
object

Parent podcast

published_at
string<date-time>

Publication date

segment_count
integer<int64>

Number of AI-identified segments

speakers
object[] | null

Speakers in this episode

topics
object[] | null

Topic classifications

url
string

Episode web URL