Podcast Segments
tier:standard

Get a segment

Returns a single segment by its unique identifier.

get/v1/podcasts/segments/{id}

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/segments/{id}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Segment ID

Response

OK

audio_urlstring

Direct audio URL for this segment

descriptionstring

AI-generated segment description

duration_secondsnumber double required

Segment duration

end_lineinteger

Last transcript line covered by this segment (1-indexed, inclusive). Omitted for episodes segmented before line ranges were recorded.

end_secondsnumber double required

End time within the episode — when the segment's last spoken line ends. Where start_line/end_line are present, segments partition the transcript's lines rather than tiling the wall-clock timeline, and the interval between this and the next segment's start_seconds contains no transcribed speech (typically under a second, occasionally minutes of music or silence). Segments without a recorded line range were produced by an earlier segmenter and a small share of them do leave transcript lines uncovered, so a gap between two such segments may contain real speech. Use start_line/end_line to slice a transcript losslessly.

idstring required

Unique identifier

numberinteger required

Segment position within the episode

read_typestring

For AD segments, how the ad was delivered (HOST_READ, PRE_RECORDED, NETWORK_PROMO)

start_lineinteger

First transcript line covered by this segment (1-indexed, inclusive). Line numbers match the number field of GET /v1/podcasts/episodes/{id}/transcript lines. This segment's end_line + 1 is the next segment's start_line, and the segments together cover every line of the transcript. Omitted for episodes segmented before line ranges were recorded.

start_secondsnumber double required

Start time within the episode — when the segment's first spoken line begins

summarystring

AI-generated segment summary

titlestring required

AI-generated segment title

typestring required

Segment type (INTRO, PERSONAL_BANTER, TOPIC_DISCUSSION, INTERVIEW, TRANSITION, AD, OUTRO)

urlstring

Moment link that plays the segment on Radar from start_seconds: the episode's web_url with ?t=. Ad placements are segments, so this is also the link to an ad read. On a search match's segment it comes from the match's episode. Omitted only when the segment's episode or its podcast is unavailable.

Changes

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