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.
- ✓ 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
| Capability | DIY yt-dlp + Python | TubeSubtitles Edge API |
|---|---|---|
| Ops & Cold Starts | Heavy Docker & 429 bans | ✓ Serverless single-flight + R2 cache |
| Output Contracts | Raw XML/srv3 fragments | ✓ Typed SRT, VTT, JSON/JSON3 & 6-part MD |
| Key Governance | Static 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.