API-Dokumentation

Eine REST-API für YouTube-Transkripte, Suche und Metadaten. Holen Sie sich einen API-Schlüssel über Ihr Dashboard — 100 kostenlose Credits, keine Karte erforderlich.

Authentifizierung

Übergeben Sie Ihren API-Schlüssel als Bearer-Token oder über x-api-key:

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

Basis-URL

https://getyoutubetranscript.com/api/v1

Credits & Pläne

Plan	Preis	Credits/Monat	Aufladepreis	Rate-Limit
Kostenlos	0 $	100 (einmalig)	—	60 Anfragen/Min.
Monatlich	5,00 $/Monat	1.000	2,50 $ / 1.000	200 Anfragen/Min.
Jährlich	4,50 $/Monat (54 $/Jahr)	1.000	1,50 $ / 1.000	300 Anfragen/Min.

1 Credit = 1 erfolgreiche Anfrage. Fehlgeschlagene Anfragen werden nie berechnet. Aufgeladene Zusatz-Credits verfallen 30 Tage nach dem Kauf oder am Ende des aktuellen Abrechnungszeitraums, je nachdem, was später eintritt, und erfordern ein aktives Abonnement, um genutzt werden zu können.

Endpunkte

GET/transcript1 Credit

Ruft das Transkript für ein YouTube-Video ab, inklusive Metadaten (Titel, Kanal, Thumbnail).

Parameter	Erforderlich	Beschreibung
`v`	Ja	Video-ID oder vollständige YouTube-URL
`language`	Nein	Sprachcode (Standard: en)

Anfrage

curl "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw" \
  -H "Authorization: Bearer sk_live_..."

Antwort

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39
  }
}

GET/search1 Credit / Seite

Durchsucht YouTube-Videos mit Filtern und Paginierung.

Parameter	Erforderlich	Beschreibung
`q`	Ja	Suchbegriff (mind. 2 Zeichen)
`country`	Nein	2-Buchstaben-Ländercode (Standard: us)
`language`	Nein	Sprachcode (Standard: en)
`page_token`	Nein	pagination.next_page_token der vorherigen Antwort, um die nächste Seite abzurufen
`limit`	Nein	Max. Ergebnisse (Standard 20, max. 50)

Anfrage

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

Antwort

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}

GET/resolveKostenlos

Löst ein Kanal-Handle, eine URL oder einen Benutzernamen zur zugehörigen echten Kanal-ID auf. Eine syntaktische Eingabe (bereits eine Kanal-ID oder eine URL, die eine enthält) wird sofort ohne Netzwerkaufruf aufgelöst; ein reines Handle löst eine echte Abfrage aus.

Parameter	Erforderlich	Beschreibung
`handle`	Ja	Kanal-ID, URL oder @Handle

Anfrage

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Antwort

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "scrape"
  }
}

GET/playlist1 Credit / Seite

Ruft die Videos einer Playlist ab. Gibt derzeit nur die erste Seite zurück – has_more zeigt an, ob es weitere Videos gibt, das Abrufen zusätzlicher Seiten wird jedoch noch nicht unterstützt.

Parameter	Erforderlich	Beschreibung
`list`	Ja	Playlist-ID oder URL

Anfrage

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

Antwort

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true
  }
}

Fehler

Fehler liefern zusätzlich zum HTTP-Status einen JSON-Body mit einem stabilen code-Feld zur Fallunterscheidung:

Status	Code	Bedeutung
400	`BAD_REQUEST`	Fehlender oder ungültiger Parameter
401	`MISSING_API_KEY / INVALID_API_KEY`	Kein Schlüssel angegeben, oder Schlüssel ist ungültig/widerrufen
402	`PAYMENT_REQUIRED`	Keine Credits mehr – Aufladung kaufen oder upgraden
404	`VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND`	Video oder Ressource nicht gefunden
429	`RATE_LIMITED`	Zu viele Anfragen für Ihre Plan-Stufe
503	`UPSTREAM_UNAVAILABLE`	Vorübergehendes Upstream-Problem – erneuter Versuch möglich

Demnächst verfügbar

Suche innerhalb eines Kanals, Auflistung aller Videos eines Kanals und vollständige Playlist-Paginierung befinden sich in Entwicklung. Die Verfolgung neuer Uploads per RSS ist aufgrund eines unabhängigen Problems auf Seiten von YouTube vorübergehend nicht verfügbar.

Diese API mit einem KI-Tool nutzen

Möchten Sie lieber Claude (oder ein anderes KI-Coding-Tool) diese API für Sie aufrufen lassen, statt Anfragen von Hand zu schreiben? Laden Sie den YouTube Transcript Skill herunter – einen fertigen Claude Skill, der ihm beibringt, Transkripte abzurufen, zu suchen und mehr.