TU
TubeSubtitles
OpenAPI 3.1 · Edge REST · SSE · Pure TS CLI

Sub-100ms Edge Transcript & AI API Built for RAG & Production

Retire brittle yt-dlp containers, IP blocks, and Python workers. Query cached .SRT, .VTT, millisecond .JSON cues, 6-section AI briefs, and SSE chat over one clean REST API.

No link in your clipboard?
  • ✓ OpenAPI 3.1 JSON
  • ✓ Zero R2 Egress
  • ✓ Up to 600 req/min

Engineered for AI Agents, RAG Pipelines & SaaS Backends

1 / 3 / 5c

Atomic D1 Metering

1c subtitle, 3c SSE chat, 5c once per AI brief.

SHA-256

Zero-Plaintext Keys

Rotate up to 25 scoped keys with burst limits.

0 Binaries

Pure TypeScript CLI

Batch & --summary-only with zero Python/FFmpeg.

Self-Hosted Scrapers vs. Managed Edge API

CapabilityDIY yt-dlp + PythonTubeSubtitles Edge API
Ops & Cold StartsHeavy Docker & 429 bans✓ Serverless single-flight + R2 cache
Output ContractsRaw XML/srv3 fragments✓ Typed SRT, VTT, JSON/JSON3 & 6-part MD
Key GovernanceStatic env secrets✓ Self-service console + 1-click revoke

3-Line Production Quickstart

OpenAPI 3.1 Spec (JSON)

Every account includes an immediate sandbox API key and live OpenAPI 3.1 specification.

curl -H "X-API-Key: YOUR_KEY" "https://tubesubtitles.net/api/v1/subtitles?videoId=jNQXAC9IVRw&lang=en&format=json"
curl -H "X-API-Key: YOUR_KEY" "https://tubesubtitles.net/api/v1/summary?videoId=jNQXAC9IVRw&lang=en&format=json"
curl -N -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"videoId":"jNQXAC9IVRw","message":"Core thesis?"}' "https://tubesubtitles.net/api/v1/chat"

Developer API & CLI FAQ

Auth headers, formats, rate limits, and OpenAPI.

How do I authenticate API requests?

Send X-API-Key: ytsub_live_... or Authorization: Bearer ytsub_live_.... Keys are SHA-256 hashed.

Which response formats does the Subtitles API support?

Pass ?format=srt, vtt, json, or json3. Starter+ keys unlock millisecond JSON and WebVTT.

What happens if a video has no captions or an invalid ID?

Pre-flight validation returns clean 4xx JSON and deducts 0 credits from your quota.

Generate Your First API Key in 10 Seconds

Start on the Free Developer Sandbox (15 credits/mo) and scale to 100,000 credits.

YouTube Transcript & AI Summary REST API for Developers | TubeSubtitles