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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Keyword oder erforderliche Wortgruppe für die Suche nach öffentlichen Anzeigen. |
results_limit | Optional | Maximale Anzahl eindeutiger Anzeigen, die gespeichert werden. Der Standardwert ist 100, zulässig sind ganze Zahlen von 20 bis 2.000. |
search_type | Optional | Modus des Keyword-Abgleichs. Der Standardwert ist keyword_unordered; verwenden Sie keyword_exact_phrase, wenn die Wortreihenfolge übereinstimmen muss. |
ad_type | Optional | Filter für die Anzeigenkategorie. Der Standardwert ist all; er kann auf political_and_issue_ads eingeschränkt werden. |
country | Optional | Länderfilter. Verwenden Sie ALL oder einen zweistelligen Ländercode; übermittelte Buchstabencodes werden in Großbuchstaben normalisiert. |
status | Optional | Filter für den Auslieferungsstatus. Der Standardwert ist ACTIVE; unterstützt werden ALL, ACTIVE oder INACTIVE. |
media_type | Optional | Filter für den Medientyp des Creatives. Unterstützt werden ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME oder NONE; der Standardwert ist ALL. |
sort_by | Optional | Sortierung der Ergebnisse. Der Standardwert ist total_impressions; unterstützt wird außerdem relevancy_monthly_grouped. |
start_date | Optional | Optionales Startdatum des Impressionszeitraums im Format YYYY-MM-DD. |
end_date | Optional | Optionales 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.
- Bereiten Sie eine nicht leere Abfrage vor und wählen Sie optionale Einstellungen für Abgleich, Anzeige, Land, Status, Medien, Sortierung, Zeitraum und Ergebnislimit.
- Senden Sie die Anfrage per POST an /v1/facebook-ad-library/search und speichern 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 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 trueAnwendungsfä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.
Verwandte APIs
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.