Get a segment

Returns a single segment by its unique identifier.

GET /v1/podcasts/segments/{id}

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/segments/{id}"

200

{
  "duration_seconds": 123,
  "end_seconds": 123,
  "id": "<string>",
  "number": 123,
  "start_seconds": 123,
  "title": "<string>",
  "type": "<string>",
  "audio_url": "<string>",
  "description": "<string>",
  "end_line": 123,
  "episode": {
    "id": "<string>",
    "title": "<string>",
    "podcast": {
      "id": "<string>",
      "title": "<string>",
      "best_rank": {
        "captured_at": "2023-11-07T05:31:56Z",
        "chart_type": "top_podcasts",
        "rank": 123,
        "source": "apple",
        "category_slug": "<string>",
        "country": "<string>"
      },
      "image_url": "<string>",
      "popularity": 123,
      "publisher": {
        "id": "<string>",
        "name": "<string>",
        "slug": "<string>"
      },
      "slug": "<string>"
    },
    "published_at": "2023-11-07T05:31:56Z",
    "slug": "<string>",
    "web_url": "<string>"
  },
  "read_type": "<string>",
  "start_line": 123,
  "summary": "<string>",
  "url": "<string>"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

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

Path Parameters

id · string · required

Segment ID

Response

200

application/json

OK

duration_seconds · number<double> · required

Segment duration

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

id · string · required

Unique identifier

number · integer<int64> · required

Segment position within the episode

start_seconds · number<double> · required

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

title · string · required

AI-generated segment title

type · string · required

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

audio_url · string

Direct audio URL for this segment

description · string

AI-generated segment description

end_line · integer<int64>

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

episode · object

Parent episode with podcast context

Show child attributes

read_type · string

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

start_line · integer<int64>

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.

summary · string

AI-generated segment summary

url · string

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.