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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche ö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.
- Bereiten Sie eine öffentliche Facebook-Ad-Library-URL vor, deren Pfad /ads/library lautet und deren Abfrage eine numerische id enthält.
- Senden Sie url an /v1/facebook-ad-library/ad und notieren Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
- 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 itemAnwendungsfä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.
Verwandte APIs
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.