# YouTube Video Downloader

> Download YouTube videos, subtitles, and transcripts programmatically.

Base URL: https://youtubedownloader.win

## Quick Start

POST /api/download with JSON body `{"url": "https://www.youtube.com/watch?v=..."}` to start a download.
Returns `{"ok": true, "download": {"id": "abc"}, "video": {"status": "queued"}}`.

Poll GET /api/downloads/{id} until `status` is `"done"`, then GET /api/file/{id}?dl=1 for the video.

## Subtitles & Transcript

After a download is `done`, GET /api/downloads/{id}/transcript returns the original-language
subtitles and a clean plain-text transcript:
`{"ok": true, "subtitles": [{"lang", "kind", "transcript", "srt"}]}`.
Free, no quota. `kind` is `manual` or `auto` (auto-generated captions).

## Authentication

Anonymous: 2 downloads/day, 720p max, 200MB per video. Authenticated free: 5 downloads/day,
same per-video limits. Any credit purchase raises the quality cap to 1080p. Lifetime SVIP:
no daily limit, highest available quality.

No CLI is available for this site yet. Sign in on the website (email/password or Google) to
get a session, then use `Authorization: Bearer <token>` (from that session) or the session
cookie directly to call the API.

## Full API Reference

See /llms-full.txt for complete endpoint documentation.