facebook-ad-library/
search

Öffentliche Anzeigen der Facebook Ad Library per Keyword und Filtern durchsuchen – mit Werbetreibendem, Creative-Text, Medien, Auslieferung und sichtbaren Kennzahlen als normalisierte Datensätze.

Facebook Ad Library Search API

Anzeigensuche per Keyword
Creative- und Auslieferungskontext
Öffentliche Werbedaten
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 Library Search

Ergebnisse der Facebook Ad Library Search sind öffentliche Anzeigen, die zu einem Keyword passen, mit der Seitenidentität des Werbetreibenden, Creative-Text und Medien, Auslieferungsdaten, Publisher-Plattformen, Ländern und sichtbaren Kennzahlen. Diese Datensätze unterstützen die Creative-Entdeckung, die Recherche zu Werbetreibenden, die Beobachtung aktiver Anzeigen und den Vergleich wiederholbarer Abfragen.

Funktionen der Facebook Ad Library Search API

  • Abgleich von Keywords und WortgruppenSuchen Sie mit einer nicht leeren Abfrage und wählen Sie zwischen Keyword-Abgleich ohne feste Reihenfolge und exaktem Abgleich der Wortgruppe, um zu steuern, welche öffentlichen Anzeigen passen.
  • Suchfilter und SortierungGrenzen Sie die Ergebnisse nach Anzeigentyp, Land, Auslieferungsstatus, Medientyp, Zeitraum und der unterstützten Sortierung nach Impressionen oder Relevanz ein.
  • Normalisierte Anzeigen- und Werbetreibenden-DatensätzeLiefert Archividentität der Anzeige, öffentliche Quell-URL, Kontext der Seite des Werbetreibenden, Creative-Titel, Fließtext und Erfassungszeit in einem einheitlichen Datensatz.
  • Creative, Auslieferung und öffentlicher KontextBehält verfügbare Bilder oder Videos, Start- und Endzeiten, Aktivstatus, Publisher-Plattformen, Länder, CTA-Angaben, Ziele und sichtbare Kennzahlen bei.
  • Begrenzte, deduplizierte ErfassungFordern Sie 20 bis 2.000 Ergebnisse an; doppelte Archiv-IDs oder öffentliche Anzeigen-URLs werden über die verfügbaren Ergebnisseiten hinweg nur einmal gespeichert.

Parameter der Facebook Ad Library Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Keyword oder erforderliche Wortgruppe für die Suche nach öffentlichen Anzeigen.
results_limitOptionalMaximale Anzahl eindeutiger Anzeigen, die gespeichert werden. Der Standardwert ist 100, zulässig sind ganze Zahlen von 20 bis 2.000.
search_typeOptionalModus des Keyword-Abgleichs. Der Standardwert ist keyword_unordered; verwenden Sie keyword_exact_phrase, wenn die Wortreihenfolge übereinstimmen muss.
ad_typeOptionalFilter für die Anzeigenkategorie. Der Standardwert ist all; er kann auf political_and_issue_ads eingeschränkt werden.
countryOptionalLänderfilter. Verwenden Sie ALL oder einen zweistelligen Ländercode; übermittelte Buchstabencodes werden in Großbuchstaben normalisiert.
statusOptionalFilter für den Auslieferungsstatus. Der Standardwert ist ACTIVE; unterstützt werden ALL, ACTIVE oder INACTIVE.
media_typeOptionalFilter für den Medientyp des Creatives. Unterstützt werden ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME oder NONE; der Standardwert ist ALL.
sort_byOptionalSortierung der Ergebnisse. Der Standardwert ist total_impressions; unterstützt wird außerdem relevancy_monthly_grouped.
start_dateOptionalOptionales Startdatum des Impressionszeitraums im Format YYYY-MM-DD.
end_dateOptionalOptionales Enddatum des Impressionszeitraums im Format YYYY-MM-DD; es darf nicht vor start_date liegen.

So verwenden Sie die Facebook Ad Library Search API

Senden Sie ein Keyword mit den Filtern, die Ihre Anzeigenstichprobe festlegen, und lesen Sie anschließend alle normalisierten Datensätze der abgeschlossenen asynchronen Aufgabe.

  1. Bereiten Sie eine nicht leere Abfrage vor und wählen Sie optionale Einstellungen für Abgleich, Anzeige, Land, Status, Medien, Sortierung, Zeitraum und Ergebnislimit.
  2. Senden Sie die Anfrage per POST an /v1/facebook-ad-library/search und speichern 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 und folgen Sie next_cursor, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"country":"US","status":"ACTIVE","media_type":"VIDEO","search_type":"keyword_unordered"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Facebook Ad Library Search API

  • Anzeigenentdeckung per Keyword: Nutzen Sie die gesendete Abfrage, Anzeigen-IDs, Creative-Text, Namen der Werbetreibenden und öffentliche URLs, um eine nachvollziehbare Menge passender öffentlicher Anzeigen zusammenzustellen.
  • Vergleich von Creatives und Formaten: Vergleichen Sie Creative-Titel, Fließtexte, Bilder, Videos, Anzeigeformate, CTA-Werte, Ziele und Publisher-Plattformen über die passenden Datensätze hinweg.
  • Beobachtung aktiver Anzeigen: Wiederholen Sie eine festgelegte Abfrage und vergleichen Sie Anzeigen-IDs, Aktivstatus, Start- und Endzeiten, Publisher-Plattformen und Erfassungszeiten über mehrere Beobachtungen.
  • Recherche nach Kandidaten für Werbetreibende: Nutzen Sie Seiten-IDs, Namen, Aliasse, URLs und sichtbare Seiten-Likes der Werbetreibenden sowie das passende Creative, um Seiten für eine gezielte Folgerecherche zu identifizieren.

Profi-Tipps zur Facebook Ad Library Search API

  • Verwenden Sie keyword_exact_phrase, wenn die Wortreihenfolge Bedeutung trägt, und keyword_unordered, wenn Anzeigen die Reihenfolge der Wörter variieren können.
  • Setzen Sie Filter für Land, Status, Medien, Anzeigentyp und Zeitraum, bevor Sie results_limit erhöhen, damit die gespeicherte Stichprobe fokussiert bleibt.
  • Betrachten Sie results_limit als Obergrenze der Erfassung und folgen Sie anschließend den Cursorn der Aufgabenergebnisse, bis has_more den Wert false hat, um jeden gespeicherten Datensatz zu lesen.
  • Deduplizieren Sie wiederholte Läufe anhand der Archiv-ID oder der öffentlichen Anzeigen-URL und behalten Sie extra.search_query und collected_at als Beobachtungskontext bei.
  • Behandeln Sie fehlende Werte zu Reichweite, Ausgaben, Seiten-Likes, Enddaten, Medien, CTA oder Land als nicht verfügbare öffentliche Daten statt als 0.

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

  • 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.
  • Facebook Ad Library Ad API — Eine öffentliche Anzeige der Ad Library über ihre URL erfassen – mit Feldern zu Creative, Werbetreibendem, Medien, Auslieferung, 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 Search API — FAQ

Facebook Ad Library Search API ruft öffentliche Anzeigen zu einem nicht leeren Keyword oder einer Wortgruppe samt optionalen Suchfiltern ab. Sie liefert normalisierte Anzeigenidentität, Kontext der Seite des Werbetreibenden, Creative-Text und Medien, Auslieferungsfelder und sichtbare Kennzahlen.

query ist erforderlich. Die Anfrage akzeptiert außerdem results_limit, sort_by, search_type, ad_type, country, status, media_type, start_date und end_date.

keyword_unordered gleicht die Wörter von query ab, ohne ihre ursprüngliche Reihenfolge zu verlangen, während keyword_exact_phrase die Reihenfolge der Wortgruppe beibehält. Der Standardwert ist keyword_unordered.

Ein normalisiertes Ergebnis kann Identität von Anzeige und Werbetreibendem, Creative-Text, Bilder oder Videos, Auslieferungsdaten und Status, Publisher-Plattformen, Länder, Felder zu CTA und Ziel, Seiten-Likes, Reichweite, Ausgabenkontext und Erfassungszeit enthalten. Öffentliche Felder bleiben leer, wenn sie nicht sichtbar sind.

Möglicherweise passt keine öffentliche Anzeige zum Keyword, oder die gewählten Filter für Land, Status, Medien, Anzeigentyp oder Zeitraum schließen jeden verfügbaren Datensatz aus. Auch die Verfügbarkeit der öffentlichen Quelle kann dazu führen, dass eine abgeschlossene Aufgabe leer bleibt.

results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 20 bis 2.000 als Obergrenze der zu speichernden eindeutigen Anzeigen. Folgen Sie nach Abschluss next_cursor, solange has_more den Wert true hat, um jede gespeicherte Ergebnisseite der Aufgabe zu lesen.

Jede zurückgegebene normalisierte Anzeige kostet 0,5 SocQ-Credits. Für leere Ergebnisse fällt keine Ergebnisgebühr an.