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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Bekannte 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.
- Bereiten Sie eine oder mehrere bekannte URLs öffentlicher Facebook-Videobeiträge oder Reels vor; dieser Endpunkt entdeckt keinen Video-Feed einer Seite.
- Senden Sie urls per POST an /v1/facebook/video-transcript und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- 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=50Anwendungsfä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.
Verwandte APIs
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.