---
title: "Get podcast episode transcript"
method: GET
path: "/transcripts/{episodeId}"
---

# Get podcast episode transcript

`GET /transcripts/{episodeId}`

## Request

- Base URL: `https://spoken.md`
- URL: `https://spoken.md/transcripts/{episodeId}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns a clean markdown transcript with speaker names and timestamps for any podcast episode. Use the demo key `pt_demo` to try the demo episode for free. All other episodes require a paid API key and cost 1 credit on first fetch — repeat fetches of the same episode are free.

## Path parameters

- `episodeId` string, required

## Response `200`

Transcript as markdown with speaker names and timestamps

## Other responses

- `401`: Missing or invalid API key
- `402`: No credits remaining. POST to the top_up_url, with the key in the header as usual, to purchase more.
- `404`: Episode not found or has no transcript
- `502`: Upstream error. No credit charged. Safe to retry.

---

[API](https://skmtc.dev/spoken/apis/podcast-transcripts-api.md) · [All operations](https://skmtc.dev/spoken/apis/podcast-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoken/apis/podcast-transcripts-api/revisions/3943c4c8211e?raw)