facebook/
ad-transcript

Verfügbare Transkripte gesprochener Inhalte aus Facebook-Ad-Library-URLs extrahieren – mit Text, Sprache, Format, Erfassungszeit, Quelllinks und Shortcode-Kontext.

Facebook Ad Transcript API

Anzeigen-Transkripte
Ad-Library-URLs
Text mit Quellverweis
0,5 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 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

ParameterErforderlichBeschreibung
urlsErforderlichFacebook-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.

  1. 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.
  2. Senden Sie urls per POST an /v1/facebook/ad-transcript und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
  4. 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.

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.

Weitere Plattformen entdecken

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

Facebook Ad Transcript API — FAQ

Facebook Ad Transcript API ist eine Schnittstelle, die gesprochene Inhalte aus unterstützten Facebook-Ad-Library-URLs in durchsuchbare Transkriptdatensätze umwandelt und so Anzeigenbotschaften leichter prüf- und indexierbar macht. Teams nutzen diese Datensätze für Creative-Recherche, Keyword-Archivierung und Sprachanalyse, sofern die Quelle nicht leeren Transkripttext liefert.

Jedes Element von urls muss facebook.com, www.facebook.com oder m.facebook.com verwenden und /ads/library im Pfad enthalten. Die Validierung verlangt keine numerische Anzeigen-ID, aber das gesendete Ziel muss weiterhin auf unterstützten Transkriptinhalt führen.

Jeder normalisierte Datensatz enthält id, platform, resource, type, url, text, die nullbare language, format, created_at mit dem Wert null, collected_at und extra.shortcode. Felder zu Werbetreibendem, Ausgaben, Reichweite, Targeting, Creative-Medien oder Interaktion kommen nicht hinzu.

Der Collector fragt jede eindeutige URL unabhängig ab und speichert einen Datensatz nur, wenn die Quelle nicht leeren Transkriptinhalt liefert. Nicht unterstützte Ziele oder Anzeigen ohne zugänglichen gesprochenen Text erzeugen deshalb kein Platzhalter-Ergebnis.

Behandeln Sie language als nullbar, weil die Quelle möglicherweise keine Angabe liefert. Lesen Sie format, bevor Sie den Text parsen: Inhalt, der mit einem WebVTT-Header beginnt, ist als webvtt gekennzeichnet, anderer Transkriptinhalt als plaintext.

Die Nutzung kostet 0,5 Credits pro zurückgegebenem normalisiertem Transkriptdatensatz. Für eine URL, die kein gespeichertes Ergebnis liefert, fällt nach der aktuellen Regel für leere Ergebnisse keine Gebühr pro Ergebnis an.