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"

402

{
  "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"
}

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

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), a person slug or id (as the episode speakers endpoint returns), or a knowledge graph entity slug or id.

start · number<double>

Start of the time range in seconds. Returns every line that overlaps the range, so the first line may begin before start.

end · number<double>

End of the time range in seconds. Returns every line that overlaps the range, so the last line may run past end. Defaults to the end of the episode.

Response

200

application/json

OK