Toucora API
🌐 Sprache
Entwickler-Infrastruktur

Die YouTube-Transkript-API, die Entwickler wirklich wollen

Eine REST-API für strukturierte Transkripte aus öffentlichen YouTube-Videos, Playlists und Kanälen. Planbare Credits, maschinenlesbare Ausgabe und klare Fehler. Kostenlos starten.

Request
# quickstart.sh
curl "https://api.example.com/v1/transcripts/VIDEO_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "duration": 213,
  "segments": [
    { "text": "...", "start": 18.64, "duration": 3.24 }
  ]
}

Jedes Format, das du brauchst

Verlange das Format, das du bereits nutzt. Antworten sind stabil und mit Zeitstempeln — nachgelagerte Tools raten nie.

Transcripts

Single video, batch up to 50, playlists and channels. JSON, TXT, SRT, VTT, Markdown.

GET /v1/transcripts/{videoId}

Jobs & webhooks

Large requests become asynchronous jobs with per-item status, retries and webhooks.

POST /v1/jobs

AI endpoints

Grounded answers with timestamps, summaries and chapters. Small and focused at launch.

POST /v1/ask

Gebaut für echte Transkript-Arbeit

RAG und KI-Agenten

Speise Embeddings, Vektordatenbanken und LLM-Pipelines mit sauberen, zeitgestempelten Transkripten — ohne selbst Untertitel zu scrapen.

Forschung und Analyse

Hole Transkripte für eine Playlist oder einen ganzen Kanal in einem Job und analysiere Themen, Stimmung oder Sprechzeit.

Untertitel und Barrierefreiheit

Exportiere SRT, VTT oder reinen Text, um Untertitel zu veröffentlichen, ein zugängliches Archiv zu bauen oder Video in Artikel zu verwandeln.

Automatisierung und Tools

Binde Transkripte in MCP-Server, Claude Code und Codex ein, damit deine Agenten jedes Video auf Abruf lesen.

Pricing

Free for a limited time

10,000 credits free for any account — no credit card, no signup wall to try.

Paid plans are coming soon. While the API is in early access, everything is included at no cost.

Limits are configuration-driven and may change as the API stabilises.

Authentication

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Keys are hashed at rest, shown once, revocable, and scoped per account.

Errors you can handle

{
  "error": {
    "code": "TRANSCRIPT_NOT_AVAILABLE",
    "message": "...",
    "request_id": "req_123"
  }
}

Every request carries an X-Request-ID for support and debugging.

OpenAPI

The canonical schema is published and importable into Postman and other tooling.

Häufige Fragen

Gibt es eine kostenlose YouTube-Transkript-API?

Ja. Jedes Konto erhält 10.000 kostenlose Credits und einen Entwicklerschlüssel — ohne Kreditkarte. Ein Video kostet einen Credit, du kannst also ohne Kosten entwickeln und testen.

Wie bekomme ich mit einer API ein Transkript von YouTube?

Rufe GET /v1/transcripts/{videoId} mit deinem Schlüssel im Authorization-Header auf. Du erhältst Transkript, Sprache, Dauer und zeitgestempelte Segmente als JSON.

Unterstützt die API Untertitel in anderen Sprachen?

Ja. Liste die Spuren mit GET /v1/transcripts/{videoId}/languages auf und übergib ?lang= für die gewünschte. Automatische Untertitel sind gekennzeichnet.

Welche Ausgabeformate liefert die API?

JSON, TXT, SRT, VTT und Markdown. Nutze ?format= in Transkript-Anfragen oder wandle das JSON selbst um — Segmente sind Text plus Start und Dauer.

Gibt es ein Python-Beispiel?

Ja. Ein paar Zeilen mit requests oder httpx genügen — im Blog findest du einen Python-Quickstart inklusive Batching und Retries.

Kann ich eine ganze Playlist oder einen Kanal abrufen?

Ja. Sende bis zu 50 Video-IDs an POST /v1/transcripts oder starte einen Playlist- oder Kanal-Job, der pro Video ein Ergebnis mit Einzelstatus liefert.

Gibt es einen MCP-Server für YouTube-Transkripte?

Ja. Ein MCP-Server stellt Transkript-Tools für Claude Code, Codex und andere MCP-Clients bereit, damit ein Agent ein Video ohne eigenen Code lesen kann.

Was kostet es?

Die API ist im Early Access kostenlos: 10.000 Credits pro Konto und 60 Anfragen/Minute. Bezahlpläne mit höheren Limits folgen bald.

Starte heute mit Transkripten

Erstelle einen kostenlosen Entwicklerschlüssel, stelle in einer Minute deine erste Anfrage und liefere Transkripte, die Nutzer durchsuchen, zitieren und exportieren können.