---
title: "Get episode transcript"
method: GET
path: "/api/episodes/{episode_id}/transcript"
tags: ["Episodes"]
---

# Get episode transcript

`GET /api/episodes/{episode_id}/transcript`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/episodes/{episode_id}/transcript`
- Auth: HTTP bearer

Returns the transcript on its own (segments + speaker list). Equivalent to the `transcript` field on `GET /api/episodes/{id}?include=transcript`. Use this endpoint when you don't need the metadata envelope.

## Path parameters

- `episode_id` string, required

## Response `200`

Transcript segments + speaker list

- Transcript
  - `partial` TranscriptPartial
    - `pieces_done` integer, required
    - `pieces_total` integer, required
    - `seconds_total` integer, required
    - `seconds_transcribed` integer, required
    - `speakers_final` boolean, required
  - `segments` TranscriptSegment[], required
    - `end` number, double, required
    - `speaker` string, nullable
    - `start` number, double, required
    - `text` string, required
  - `speakers` string[], required
  - `total_segments` integer, required

## Other responses

- `206`: Recording still being transcribed in parts: the finished parts, with `partial` set (speaker labels provisional)
- `401`: Missing or invalid API key
- `402`: No active subscription (paid endpoint requires a subscription)
- `403`: Endpoint not available on the caller's plan
- `404`: Episode not found or has no transcript
- `429`: Monthly quota exhausted (response includes `usage: { current, limit }`)

---

[API](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api.md) · [All operations](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/revisions/29b5788227cf?raw)