Get a transcript excerpt around a moment

Returns one segment of an episode’s transcript: the latest segment starting at or before at (seconds), or the opening segment when at is omitted. A moment falling between two segments resolves to the earlier one, and a moment outside the episode clamps to the first or last segment, so the returned range does not always contain at — segment_start_seconds and segment_end_seconds report what was actually returned. Every caller gets the same excerpt for a given moment regardless of plan, so unlike the full transcript this response is cacheable and safe to render for signed-out visitors. Use this to open a deep link on a moment; use get-episode-transcript for the whole episode.

GET /v1/podcasts/episodes/{id}/transcript/preview

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/episodes/{id}/transcript/preview?format=dialogue"

default

{
  "detail": "Property foo is required but is missing.",
  "error_code": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "resolve": {
    "message": "<string>",
    "action": "<string>",
    "endpoint": "<string>",
    "method": "<string>",
    "url": "<string>"
  },
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

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

Path Parameters

id · string · required

Episode slug or ID

Query Parameters

at · number<double>

A moment in the episode, in seconds. Returns the latest segment starting at or before it, which is not always a segment containing it: a value falling in the gap between two segments resolves to the earlier one, and a value outside the episode clamps to the first or last segment. Read segment_start_seconds/segment_end_seconds for the range actually returned. Omit for the opening segment.

format · enum<string> · default: dialogue

Output format: dialogue (speaker-attributed lines), text (plain text), srt (SubRip subtitles)

Available options: dialogue, text, srt

Response

200

application/json

OK