Facebook Ad Transcript
Facebook Ad Transcript bezeichnet Datensätze zu gesprochenen Inhalten von Zielen der Ad Library, mit Quell-URLs, Text, Sprache, Format, Erfassungszeit und optionalem Shortcode-Kontext. Diese Datensätze unterstützen die Prüfung von Botschaften, die Indexierung von Keywords, sprachabhängige Verarbeitung und Archive mit Quellverweis.
Funktionen der Facebook Ad Transcript API
- Stapel von Ad-Library-URLsAkzeptiert Facebook-Ad-Library-URLs von unterstützten Facebook-Hosts und verarbeitet jede eindeutige URL als eigenständiges Transkriptziel.
- Gesprochener Text mit QuellverweisLiefert nicht leeren Transkripttext mit der gesendeten Quell-URL und einer Kennung, die auf die URL zurückfällt, wenn keine Quell-ID vorhanden ist.
- Sprach- und FormatkontextNimmt eine nullbare Quellsprache, das Format Klartext oder WebVTT, die Erfassungszeit und einen optionalen Shortcode in den normalisierten Datensatz auf.
- Nur verfügbare DatensätzeSpeichert ein Ergebnis nur, wenn das gewählte Anzeigenziel nicht leeren Transkriptinhalt liefert, sodass eine erfolgreiche Aufgabe weniger Datensätze als gesendete URLs zurückgeben kann.
Parameter der Facebook Ad Transcript API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Facebook-Ad-Library-URLs auf unterstützten Facebook-Hosts, durch Kommas oder Zeilenumbrüche getrennt; jeder Pfad muss /ads/library enthalten. |
So verwenden Sie die Facebook Ad Transcript API
Senden Sie Facebook-Ad-Library-URLs und gleichen Sie die zurückgegebenen Quell-URLs ab, denn nur Ziele mit nicht leerem Transkripttext erzeugen Ergebniselemente.
- Bereiten Sie eine oder mehrere Facebook-Ad-Library-URLs vor, deren Host facebook.com, www.facebook.com oder m.facebook.com lautet und deren Pfad /ads/library enthält.
- Senden Sie urls per POST an /v1/facebook/ad-transcript und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
- Lesen Sie data.results.items und fordern Sie mit results.next_cursor die nächste Seite an, wenn results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook/ad-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/ads/library/?id=123456789012345"]}'
# Poll GET /v1/tasks/{task_id}
# Continue with GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}Anwendungsfälle der Facebook Ad Transcript API
- Prüfung von Werbebotschaften: Lesen Sie Transkripttext mit Quellverweis, um die gesprochene Wortwahl über eine ausgewählte Menge öffentlicher Anzeigenziele hinweg zu vergleichen.
- Indexierung gesprochener Anzeigeninhalte für die Suche: Indexieren Sie Text mit Datensatz-IDs, Quell-URLs, Erfassungszeiten und Shortcode-Kontext, damit sich bekannte Anzeigen-Transkripte nach gesprochenen Begriffen durchsuchen lassen.
- Weiterleitung für die Transkriptverarbeitung: Nutzen Sie die Felder zu Sprache und Format, um Datensätze in Klartext und WebVTT an die passende Pipeline für Text, Untertitel oder Sprachverarbeitung zu leiten.
Profi-Tipps zur Facebook Ad Transcript API
- Verwenden Sie einen unterstützten Facebook-Host und behalten Sie /ads/library in jedem URL-Pfad bei; andere Hosts oder Pfade scheitern an der Anfragevalidierung.
- Kanonisieren Sie Ad-Library-URLs vor dem Bündeln, wenn dasselbe Ziel mit unterschiedlichen Query-Strings auftritt, denn der Collector entfernt nur exakt doppelte Zeichenfolgen.
- Vergleichen Sie nach dem Erfolg die zurückgegebenen url-Werte mit der gesendeten Liste, damit nicht unterstützte Anzeigen und Ziele ohne nicht leeren Transkriptinhalt in Ihrem Workflow sichtbar bleiben.
- Verzweigen Sie das Parsing nach format und behandeln Sie language und extra.shortcode als nullbare Werte; created_at ist reserviert und liefert derzeit null.
- Folgen Sie results.next_cursor, solange results.has_more den Wert true hat, wenn ein großer URL-Stapel mehr als das angeforderte Limit einer Ergebnisseite umfasst.
Verwandte APIs
Ergänzend zur Facebook Ad Transcript API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook-Daten benötigen.
- Facebook Pages API — Öffentliche Seitenprofile, Kontaktdaten, Bilder und sichtbare Publikumsbewertungen abrufen.
- Facebook Posts API — Öffentliche Beiträge, Medien, Reaktionen, Kommentare und Shares aus unterstützten Facebook-URLs erfassen.
- Facebook Video Transcript API — Verfügbaren Transkripttext und das Format aus bekannten öffentlichen Video-Beitrags- oder Reel-URLs extrahieren.
- 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 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.