# Changelog of YouTube Transcript Scraper (`chilly_damask/youtube-transcript-scraper`) Actor

- **URL**: https://apify.com/chilly_damask/youtube-transcript-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/chilly_damask/youtube-transcript-scraper.md

## Changelog

### 1.0.0 — 2026-07-15

First public release.

- Public, **signed-out** extraction of YouTube video transcripts — no login, no API keys, no cookies, no browser, HTTP-only (the public player endpoint + its signed timedtext URLs).
- Input: video **URLs in any common form** (`watch?v=`, `youtu.be`, `/shorts/`, `/embed/`, `/live/`) and/or bare 11-char **video ids**, deduped run-wide.
- Output grain: **one record per transcript** (video × caption track) with timestamped `{ start, dur, text }` segments, full plain text, word/segment/char counts, video metadata, and the full `availableLanguages` list.
- Language selection: request specific codes (base code matches regional variants) or leave empty for **every published language**; `includeAutoGenerated` switch; `preferManual` returns only the manual track when a language has both.
- Dependency-free parser for all three YouTube transcript wire formats: **srv3 XML** (incl. word-level `<s>` children on auto-generated tracks), **classic XML**, and **json3**.
- Pay-per-event pricing: **$0.005 per transcript returned** — no transcript, no charge (caption-less, unavailable, and failed videos come back as free `status: "error"` rows).
- Resilient engine: 3 retries with backoff, body-download-safe timeout, response-size cap, run-global dedupe by video id, and honest `{ "status": "error" }` rows instead of run crashes.

#### Scope

- Captions only — no speech-to-text of caption-less videos, and no auto-translation into languages the video doesn't publish. Age-restricted / region-locked videos may be unplayable signed out and return free error rows.

#### Roadmap

- Optional auto-translated tracks (YouTube `tlang`) behind an explicit input flag.
- Channel / playlist URL expansion to video lists.
- SRT / VTT export format hints.
