Tags: TranscriptFetch/transcript-api-python

2.5.0: markdown and chunks on video() and batch()

2.4.0: add sync and async monitor lifecycle and event pagination

2.3.0

2.2.0: drop podcast support (Spotify, Apple Podcasts, RSS retired by …

…the API on 2026-09-10)

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Bvy7DkJCC1ubcKyJEGgmsm

2.1.0

2.0.0: API v2

Targets /api/v2: one error block on every failure (code, number, message,
docs, retry_with | details | issues), family-based exception classes
(NotFoundError, BatchTooLargeError, UnprocessableInputError), ApiErrorBlock
model, batch entries with three outcomes and an error block,
Transcript.source and Transcript.error. v1 stays reachable until
2027-09-03; 1.x keeps working.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_014Pvnuti4G9iijR3mRCw9CH

Batch audio fallback: mode param, processing entries, drop cached

The batch endpoint now transcribes captionless entries from audio by
default. Type that end to end:

- transcripts.batch() (sync + async) gains mode="auto" | "captions";
  omitted means the server default (auto). "audio" is not accepted on
  batch.
- BatchResult gains job_id and status for entries that came back as
  outcome "processing" (free on that call, billed on delivery at the
  audio rate; re-send the batch or poll transcripts.job()).
- BatchResult.cached deprecated: the API omits the key entirely now, so
  a defaulted bool silently misreported. Optional[bool] = None keeps
  1.x import/attribute compatibility without inventing False.
- Segment gains optional speaker (int), the best-effort diarization
  label podcast transcriptions carry.
- Map wire code "upstream_error" (503 upstream platform block) to
  UpstreamUnavailableError by code as well as status; retries already
  covered 503 and are unchanged. Per-key limits remain 429.

Version 1.0.2.

Co-Authored-By: Claude Fable 5 <[email protected]>

1.0.1

Ships the podcast documentation and the typed podcast block (b3b3942),
which landed after the 1.0.0 tag.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>

1.0.0: 8/8 endpoints, podcast support, async job path, stable API