facebook-ad-library/
ad

Eine öffentliche Anzeige der Facebook Ad Library über ihre Anzeigen-URL abrufen – mit Creative-Text, Kontext des Werbetreibenden, Medien, Auslieferungszeitraum und sichtbaren Signalen als normalisierter Datensatz.

Facebook Ad Library Ad API

Ad-Library-URL
Creative und Kontext des Werbetreibenden
Öffentliche Auslieferungssignale
0,6 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 Library Ad

Anzeigen der Facebook Ad Library sind öffentliche Werbedatensätze mit Creative-Text, Identität des Werbetreibenden, Medien, Handlungsaufforderungen, Auslieferungszeitraum, Aktivstatus sowie verfügbaren Signalen zu Reichweite oder Ausgaben. Diese Felder eignen sich für die Anreicherung ausgewählter Anzeigen, die Prüfung von Creatives, die Beobachtung der öffentlichen Auslieferung und den Vergleich zu bestimmten Zeitpunkten.

Funktionen der Facebook Ad Library Ad API

  • Direkte Auflösung von Ad-Library-URLsLöst eine öffentliche /ads/library-URL mit numerischem Abfrageparameter id in höchstens einen normalisierten Anzeigendatensatz auf.
  • Creative und Kontext des WerbetreibendenLiefert die Archiv-ID der Anzeige, Titel und Text des Creatives, die Identität der werbenden Seite, die öffentliche Seiten-URL, die Handlungsaufforderung und den Ziellink, sofern verfügbar.
  • Auslieferung und sichtbare SignaleBehält Start- und Endzeit, Aktivstatus, Publisher-Plattformen, Länderkontext, Seiten-Likes, Reichweite, Währung und Ausgaben bei, sofern der öffentliche Datensatz sie enthält.
  • Normalisierte Medien mehrerer KartenWählt für die Standardfelder verfügbaren Snapshot-Text oder den Text der ersten Karte aus und dedupliziert Bild- und Video-Assets aus Snapshot und Karten, ohne eine vollständige Variantentabelle darzustellen.

Parameter der Facebook Ad Library Ad API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche öffentliche URL einer Facebook-Ad-Library-Anzeige. Verwenden Sie die kanonische Form https://www.facebook.com/ads/library/?id={numeric_id}; eine Anfrage akzeptiert eine URL.

So verwenden Sie die Facebook Ad Library Ad API

Senden Sie eine öffentliche Ad-Library-URL, verfolgen Sie die asynchrone Aufgabe und lesen Sie den normalisierten Anzeigendatensatz aus dem Standard-Ergebnisumschlag.

  1. Bereiten Sie eine öffentliche Facebook-Ad-Library-URL vor, deren Pfad /ads/library lautet und deren Abfrage eine numerische id enthält.
  2. Senden Sie url an /v1/facebook-ad-library/ad und notieren Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items; dieser Endpunkt liefert höchstens einen Datensatz, deshalb bleibt next_cursor normalerweise null und has_more bleibt false.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one item

Anwendungsfälle der Facebook Ad Library Ad API

  • Ausgewählte Anzeige anreichern: Ergänzen Sie einen vorhandenen Anzeigendatensatz um Archiv-ID, Identität des Werbetreibenden, Titel des Creatives, Fließtext, Medien, CTA, Ziel-URL und Eingabe-URL.
  • Creative-Assets und Ziele prüfen: Prüfen Sie deduplizierte Bild- oder Videoverweise zusammen mit Anzeigeformat, CTA-Text, CTA-Typ und dem öffentlichen Ziellink einer bekannten Anzeige.
  • Öffentlichen Auslieferungskontext prüfen: Nutzen Sie Aktivstatus, Start- und Endzeit, Publisher-Plattformen, Länderwerte und verfügbare Felder zu Reichweite oder Ausgaben, um den öffentlichen Auslieferungskontext zu untersuchen.
  • Anzeigen-Momentaufnahmen festhalten: Speichern Sie Creative, Werbetreibenden, Auslieferung, sichtbare Signale, Eingabe-URL und collected_at, um dieselbe bekannte Anzeige später zu vergleichen.

Profi-Tipps zur Facebook Ad Library Ad API

  • Senden Sie eine Ad-Library-URL mit exakt dem Pfad /ads/library und einem numerischen Abfrageparameter id; Seiten-URLs, Seiten-IDs, Beitrags-URLs und reine Anzeigen-IDs werden als Eingabe nicht akzeptiert.
  • Werten Sie eine erfolgreiche Aufgabe ohne Datensatz als gültiges Ergebnis „nicht verfügbar“ oder „nicht gefunden“, wenn die gesendete URL syntaktisch gültig ist.
  • Behandeln Sie Reichweite, Ausgaben, Seiten-Likes, Medien, end_at, die Profil-URL des Werbetreibenden, CTA und Länderwerte als optionale öffentliche Felder und wandeln Sie fehlende Werte nicht in 0 um.
  • Verwenden Sie bei Anzeigen mit mehreren Karten oder Creatives den normalisierten Namen und Text als repräsentative Felder und prüfen Sie die deduplizierte Medienliste, ohne sie für eine vollständige Tabelle aller Varianten zu halten.

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

  • Facebook Ad Library Search API — Öffentliche Anzeigen per Keyword suchen – mit Optionen für Treffer, Anzeige, Land, Status, Medien, Sortierung, Datum und Ergebnislimit.
  • Facebook Ad Library Company Search API — Seiten von Werbetreibenden anhand des Unternehmens- oder Seitennamens finden – mit Seiten-IDs, Klassifizierungen, Bildern, sichtbarer Reichweite und verknüpften Instagram-Signalen.
  • Facebook Ad Library Company Ads API — Öffentliche Anzeigen zur Seiten-ID eines Werbetreibenden erfassen – mit Feldern zu Creative, Auslieferung, Markt, Medien, CTA und sichtbaren Signalen.

Weitere Plattformen entdecken

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

Facebook Ad Library Ad API — FAQ

Facebook Ad Library Ad API ruft eine öffentliche Anzeige über eine gesendete Ad-Library-URL ab. Sie liefert normalisierten Creative-Text, Kontext des Werbetreibenden, Medien, Auslieferungszeitraum, Handlungsaufforderungen und verfügbare öffentliche Signale.

Senden Sie eine öffentliche URL in der kanonischen Form https://www.facebook.com/ads/library/?id={numeric_id}. Der Pfad muss /ads/library lauten, und der Abfrageparameter id muss numerisch sein.

Ein Datensatz kann die Archiv-ID und URL der Anzeige, Titel und Text des Creatives, Felder der werbenden Seite, Medien, Auslieferungsdaten und Status, Publisher-Plattformen, Länderwerte, Angaben zur Handlungsaufforderung, Ziel-URL, Seiten-Likes, Reichweite, Währung, Ausgaben und Erfassungskontext enthalten.

Eine syntaktisch gültige URL kann auf eine nicht verfügbare oder nicht gefundene öffentliche Anzeige verweisen. In diesem Fall kann die Aufgabe erfolgreich sein, ohne ein Platzhalter-Ergebnis zu erzeugen.

Der normalisierte Name und Text übernehmen verfügbare Werte aus dem Snapshot oder der ersten Karte, während media die eindeutigen Assets aus Snapshot und Karten enthält. Der Datensatz ist keine vollständige Tabelle aller Creative-Varianten.

Jeder erfolgreich zurückgegebene Anzeigendatensatz kostet 0,6 SocQ-Credits. Für eine Aufgabe ohne Ergebnis fällt keine Ergebnisgebühr an.