Get episode transcript

Returns the diarized transcript for a podcast episode. Supports dialogue (speaker-attributed lines), plain text, and SRT subtitle formats. Optionally filter by speaker or time range.

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

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/episodes/{id}/transcript?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

format · enum<string> · default: dialogue

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

Available options: dialogue, text, srt

speaker · string

Filter to lines from a specific speaker. Accepts a speaker name (full or partial, case-insensitive) or a knowledge graph entity reference (canonical id or slug).

start · number<double>

Start time in seconds for time-range clipping

end · number<double>

End time in seconds for time-range clipping

Response

200

application/json

OK