YouTube Transcripts
YouTube-Transkripte sind Klartextfassungen der verfügbaren Untertitel öffentlicher Videos, mit Sprache, Quelle der Untertitel, Kanalkontext, Angaben zur Veröffentlichung und Dauer. Dieser Text unterstützt Barrierefreiheit, Suche, die Prüfung von Zitaten, Themenanalysen, Zusammenfassungen und die Indexierung von Inhalten.
Funktionen der YouTube Transcripts API
- Transkriptabruf für mehrere VideosRufen Sie verfügbaren Transkripttext aus mehreren öffentlichen Video-URLs in einer einzigen Anfrage ab.
- Wahl der bevorzugten SpracheFordern Sie eine bevorzugte Sprache mit einem gültigen BCP-47-Code wie en oder zh-CN an.
- Metadaten zur SprachverfügbarkeitLiefert die tatsächlich gewählte Sprache und die Liste der verfügbaren Transkriptsprachen.
- Transkriptformat als KlartextBietet ein einheitliches Klartextformat mit Angaben zur Quelle des Transkripts, sofern bekannt.
- Nachvollziehbarer VideokontextVerbindet jedes Transkript mit Video-ID, Titel, Kanalinformationen, Veröffentlichungsdatum, Dauer und collected_at.
Parameter der YouTube Transcripts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche YouTube-Video-URLs, getrennt durch Kommas oder Zeilenumbrüche. |
language | Optional | Optionale bevorzugte Untertitelsprache im BCP-47-Format, zum Beispiel en oder zh-CN; die zurückgegebene Sprache kann abweichen. |
So verwenden Sie die YouTube Transcripts API
Fordern Sie Untertitel erst an, nachdem Sie die relevanten Videos ausgewählt haben. Prüfen Sie dann die zurückgegebene Sprache und Quelle, bevor der Text in Such-, RAG-, Zusammenfassungs-, Übersetzungs- oder Compliance-Workflows gelangt.
- Wählen Sie öffentliche Video-URLs, am besten nachdem eine Suche oder die Prüfung der Metadaten irrelevante Einträge entfernt hat.
- Senden Sie urls und optional eine language im BCP-47-Format per POST an /v1/youtube/transcripts und speichern Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab; ein erfolgreicher Batch kann trotzdem weniger Ergebnisse als übergebene URLs enthalten.
- Prüfen Sie für jedes Element language, available_languages und transcript_source, bevor Sie den Klartext in Abschnitte teilen; paginieren Sie, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/transcripts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Anwendungsfälle der YouTube Transcripts API
- Zusammenfassung von Videos: Nutzen Sie verfügbaren Transkripttext, um Zusammenfassungen, Recherchenotizen oder Content-Briefings für lange Videos zu erstellen.
- Durchsuchbare Videoarchive: Indexieren Sie Transkripttext zusammen mit Video-IDs, Titeln, Kanalinformationen und Sprachmetadaten.
- Extraktion von Themen und Informationen: Erkennen Sie Themen, Entitäten, Aussagen und Keywords in einer ausgewählten Sammlung öffentlicher Videos.
- Übersetzung und Lokalisierung: Nutzen Sie die Felder zur gewählten und zur verfügbaren Sprache, um Transkripttext in Übersetzungs-Workflows zu leiten.
Profi-Tipps zur YouTube Transcripts API
- Richten Sie sich immer nach der zurückgegebenen Sprache und nicht nach der angeforderten Präferenz. Der Fallback kann zu Recht eine andere verfügbare Spur wählen.
- Automatisch erzeugte Untertitel können Fehler bei Namen, Zeichensetzung und Fachbegriffen enthalten. Behalten Sie transcript_source bei und prüfen Sie wichtige Auszüge anhand des Videos.
- Eine erfolgreiche Aufgabe mit weniger Elementen bedeutet meist, dass einige Videos keine nutzbaren öffentlichen Untertitel hatten; das ist nicht automatisch ein Fehlschlag des Batches.
- Klartext enthält keine Zeitstempel für Segmente und keine Sprecherkennzeichnung. Leiten Sie aus dieser Antwort keine genauen Zeitangaben für Zitate ab.
- Teilen Sie den Text später in Abschnitte, behalten Sie aber Video-ID, Sprache, Quelle und collected_at bei jedem Abschnitt bei, damit Quellenangaben nachvollziehbar bleiben.
- Nutzen Sie Videos, um Titel, Medien und öffentliche Kennzahlen zu ergänzen, wenn das Transkript in einem durchsuchbaren Katalog erscheinen soll.
- Wenn eine exakte Sprachabdeckung zwingend ist, vergleichen Sie zuerst available_languages und behandeln Sie Fallback-Ergebnisse als Ausnahmen, die eine Prüfung erfordern.
Verwandte APIs
Ergänzend zur YouTube Transcripts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.
- YouTube Channel Videos API — Reguläre öffentliche Videos aus Kanal-URLs erfassen – ohne Shorts und Livestreams.
- YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
- YouTube Channels API — Öffentliche Kanalidentität, Bilder, Verifizierung und sichtbare Statistiken zur Zielgruppe abrufen.
- YouTube Videos API — Metadaten, Thumbnails, Dauer und Interaktionen zu bekannten Video- oder Short-URLs abrufen.
- YouTube Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
- YouTube Channel Live Videos API — Öffentliche Übertragungen erfassen, die in den Live-Bereichen eines Kanals angezeigt werden – mit Quellkontext und sichtbaren Kennzahlen.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API