facebook/
video-transcript

Verfügbaren Transkripttext aus URLs öffentlicher Facebook-Videobeiträge und Reels extrahieren – mit Quelllinks, Format und Erfassungszeit als normalisierte Datensätze.

Facebook Video Transcript API

Video-Transkripte
Bekannte URLs
Text mit Quelllink
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Facebook Video Transcript

Facebook-Video-Transkripte enthalten den gesprochenen Text öffentlicher Videobeiträge und Reels, mit Quell-URLs, Transkripttext, Format und Erfassungszeit. Diese Datensätze eignen sich für die Indexierung von Sprache, die Prüfung ausgewählter Inhalte, Archive mit Quelllink und die Anreicherung neben separat gesammelten Beitragsmetadaten.

Funktionen der Facebook Video Transcript API

  • Transkript-Stapel für bekannte URLsNimmt eine Liste von URLs öffentlicher Facebook-Videobeiträge oder Reels entgegen und entfernt vor dem Abruf der Transkripte exakt identische Zeichenfolgen.
  • Transkriptdatensätze mit QuelllinkLiefert jedes verfügbare Transkript mit der übergebenen Quell-URL und einer Datensatz-ID, die auf diese URL zurückfällt.
  • Ausdrückliches TextformatKennzeichnet den zurückgegebenen Text als plaintext oder WebVTT und enthält die Erfassungszeit des Transkripts für die weitere Verarbeitung.
  • Nur verfügbare ErgebnisseErzeugt nur dann einen normalisierten Datensatz, wenn eine übergebene öffentliche URL nicht leeren Transkripttext liefert; die Zahl der Ergebnisse kann daher unter der Zahl der Eingaben liegen.

Parameter der Facebook Video Transcript API

ParameterErforderlichBeschreibung
urlsErforderlichBekannte URLs öffentlicher Facebook-Videobeiträge oder Reels, getrennt durch Kommas oder Zeilenumbrüche.

So verwenden Sie die Facebook Video Transcript API

Senden Sie bekannte URLs öffentlicher Facebook-Videobeiträge oder Reels und gleichen Sie die zurückgegebenen Quell-URLs ab, denn nur nicht leerer Transkripttext erzeugt Ergebniseinträge.

  1. Bereiten Sie eine oder mehrere bekannte URLs öffentlicher Facebook-Videobeiträge oder Reels vor; dieser Endpunkt entdeckt keinen Video-Feed einer Seite.
  2. Senden Sie urls per POST an /v1/facebook/video-transcript und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
  4. Lesen Sie data.results.items, folgen Sie next_cursor, solange has_more den Wert true hat, und verwenden Sie beim Speichern des Textes jeweils url und format.
curl -X POST "https://api.socq.ai/v1/facebook/video-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/reel/1535656380759655"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Anwendungsfälle der Facebook Video Transcript API

  • Indexierung gesprochener Inhalte für die Suche: Indexieren Sie Transkripttext mit Quell-URL, Datensatz-ID, Format und Erfassungszeit, damit sich ausgewählte öffentliche Videos nach gesprochenen Wörtern durchsuchen lassen.
  • Prüfung ausgewählter Videos und Reels: Nutzen Sie Transkripttext mit Quelllink, um das gesprochene Material einer kuratierten Auswahl bekannter URLs öffentlicher Videobeiträge und Reels zu prüfen.
  • Anreicherung von Beitragsmetadaten: Verknüpfen Sie Transkripttext über die Quell-URL mit separat gesammelten Beitragsdetails, wenn ein Datensatz sowohl gesprochene Inhalte als auch öffentlichen Beitragskontext benötigt.

Profi-Tipps zur Facebook Video Transcript API

  • Übergeben Sie bekannte URLs öffentlicher Videobeiträge oder Reels erst, nachdem Sie geprüft haben, dass jedes Ziel erreichbar ist; fehlerhafte, private, entfernte oder nicht unterstützte Medien können ohne Datensatz bleiben.
  • Vereinheitlichen Sie URL-Zeichenfolgen vor dem Bündeln, wenn dasselbe Video mit Tracking-Parametern oder in alternativen URL-Formen auftauchen kann, denn das Backend entfernt nur exakte Duplikate.
  • Vergleichen Sie nach dem Erfolg die zurückgegebenen url-Werte mit der übergebenen Liste, damit URLs ohne nicht leeren Transkripttext in Ihrem Workflow sichtbar bleiben.
  • Lesen Sie format, bevor Sie den Text parsen; ein Datensatz im Format webvtt kann Cue-Markup enthalten, das nicht als unstrukturierter Klartext verarbeitet werden sollte.
  • Fahren Sie mit results.next_cursor fort, solange has_more den Wert true hat, wenn ein Stapel von URLs mehr als eine Ergebnisseite umfasst.

Ergänzend zur Facebook Video Transcript API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook-Daten benötigen.

  • Facebook Posts API — Öffentliche Beiträge, Medien, Reaktionen, Kommentare und Shares aus unterstützten Facebook-URLs erfassen.
  • Facebook Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Medien und Quell-Links aus Beitrags-URLs erfassen.
  • Facebook Group Posts API — Öffentliche Beiträge aus URLs von Facebook-Gruppen erfassen – mit wählbarer Sortierung, Limits pro Gruppe, Autorenkontext, Videomedien und sichtbaren Interaktionen.
  • Facebook Ad Transcript API — Verfügbaren gesprochenen Text, Sprache, Format und Quellkontext aus URLs der Facebook Ad Library extrahieren.
  • Facebook Profile Photos API — Öffentliche Fotos aus Profil- oder Seiten-URLs mit Bildunterschriften, Autorenkontext, Interaktionen, Bildmetadaten und Quellverweisen erfassen.
  • Facebook Reels API — Öffentliche Reels aus Profil- oder Seiten-URLs mit Bildunterschriften, Autorenkontext, Videometadaten, sichtbaren Interaktionen und Quellverweisen erfassen.

Weitere Plattformen entdecken

Kombinieren Sie Facebook-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Facebook Video Transcript API — FAQ

Facebook Video Transcript API ist eine Schnittstelle, die verfügbaren Transkripttext aus bekannten URLs öffentlicher Facebook-Videobeiträge oder Reels extrahiert. Steht nicht leerer Transkripttext zur Verfügung, liefert sie Quell-URL, Text, Ausgabeformat und Erfassungszeit.

Übergeben Sie ein nicht leeres Array urls mit bekannten URLs öffentlicher Facebook-Videobeiträge oder Reels. Die Anfrage akzeptiert keinen Seitennamen, keine Suchanfrage, keine Sprachauswahl, kein Transkriptformat und kein results_limit.

Jeder normalisierte Datensatz enthält id, platform, resource, type, url, text, das nullable Feld language, format, created_at, collected_at und extra. Die Antwort vereinheitlicht keine Videotitel, Autoren, Dauer, Vorschaubilder, Interaktion oder Segment-Zeitstempel.

Ein Ergebnis wird nur gespeichert, wenn die Quelle nicht leeren Transkripttext zurückgibt. Private, entfernte, nicht unterstützte, nicht verfügbare oder transkriptlose Medien hinterlassen daher keine Platzhalterzeile.

Dieser Endpunkt akzeptiert keinen Sprachparameter. Das normalisierte Schema reserviert ein nullable Feld language, doch der aktuelle Facebook-Collector bietet keine Sprachauswahl und garantiert keine Angabe der Quellsprache.

Die Nutzung kostet 0,7 Credits für jedes zurückgegebene normalisierte Transkriptergebnis. Eine Eingabe-URL ohne Ergebnis verursacht nach der aktuellen Regel für leere Ergebnisse keine Kosten pro Ergebnis.