Facebook Ad Library API
Durchsuchen Sie öffentliche Facebook-Anzeigen per Keyword, finden Sie Seiten von Werbetreibenden, erfassen Sie Anzeigen zu einer Seiten-ID oder rufen Sie eine bekannte Anzeige ab – mit normalisierten Feldern zu Creative, Medien, Auslieferung, CTA und Ziel.
Verfügbare Facebook-Ad-Library-APIs
Verwenden Sie Search für die Anzeigensuche per Keyword, Company Search zum Finden einer Seiten-ID, Company Ads zum Erfassen der Anzeigen dieser Seite oder Ad Details zum Abrufen einer bekannten öffentlichen Anzeige.
Welche Facebook-Ad-Library-Daten können Sie abrufen?
SocQ liefert normalisierte öffentliche Anzeigen- und Werbetreibenden-Datensätze für Creative-Recherche, Wettbewerbsbeobachtung, Kampagnenanalyse und Werbedatensätze.
Ergebnisse der Anzeigensuche
Durchsuchen Sie öffentliche Anzeigen per Keyword oder exakter Wortgruppe, mit optionalen Filtern für Land, Status, Medien, Anzeigentyp, Datum, Sortierung und Ergebnislimit.
Datensätze zu Seiten von Werbetreibenden
Finden Sie Seiten-IDs, Namen, URLs, Kategorien, Länder, Bilder, Verifizierungswerte, sichtbare Seiten-Likes und verknüpften Instagram-Kontext.
Seitenspezifische Anzeigensammlungen
Erfassen Sie eine begrenzte Menge eindeutiger öffentlicher Anzeigen zu einer numerischen Seiten-ID eines Werbetreibenden, mit optionalen Filtern für Auslieferung und Medien.
Creative-Text und Medien
Rufen Sie verfügbare Anzeigentitel, Fließtext, Linkbeschreibungen, Anzeigeformate und deduplizierte öffentliche Bild- oder Videoverweise ab.
Auslieferungs- und Marktkontext
Behält verfügbare Start- und Endzeiten, aktiven Status, Publisher-Plattformen, Länder, Reichweite, Währung, Ausgaben und Signale zu Seiten-Likes bei.
Handlungsaufforderungen und Ziele
Rufen Sie sichtbaren CTA-Text und -Typ, öffentliche Ziel-URLs, Ad-Library-URLs, Identität des Werbetreibenden und Erfassungszeitstempel ab, sofern sie bereitgestellt werden.
SocQ vs Meta Ad Library API
SocQ bietet sofort nutzbare Workflows zur Erfassung öffentlicher Anzeigen. Die Ad Library API von Meta ist die offizielle Wahl für den direkten Zugriff auf Metas Archiv zur Werbetransparenz.
| Funktion | SocQ | Meta Ad Library API |
|---|---|---|
| Hauptzweck | Öffentliche Anzeigen durchsuchen und Details zu Werbetreibenden oder Anzeigen erfassen | Abfrage von Metas offiziellem Archiv zur Werbetransparenz |
| Authentifizierung | SocQ-API-Schlüssel; kein Facebook-OAuth des Kunden | Meta-App, Zugriffstoken und Zugang zur Ad Library |
| Ausgangseingabe | Keyword, Unternehmensname, Seiten-ID oder öffentliche Ad-Library-URL | Abfrageparameter des offiziellen Archivs und Meta-Kennungen |
| Anzeigen erstellen oder verwalten | Nicht unterstützt | Nicht unterstützt; nutzen Sie die Meta Marketing API |
| Antwortformat | Normalisierte SocQ-Datensätze | Native Objekte der Meta Graph API |
So funktioniert die Facebook Ad Library API
Alle vier APIs nutzen denselben asynchronen Aufgaben-Workflow mit paginierten Ergebnissen.
1. API und Eingabe wählen
Beginnen Sie je nach benötigtem Datensatz mit einem Keyword, Unternehmensnamen, einer numerischen Seiten-ID oder einer öffentlichen /ads/library-URL.
2. Aufgabe senden und verfolgen
Senden Sie die passende POST-Anfrage, speichern Sie die zurückgegebene task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.
3. Normalisierte Ergebnisse lesen
Verarbeiten Sie data.results.items und folgen Sie next_cursor, solange has_more true ist.
Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie ein Keyword an den Search-Endpunkt. Die anderen Ad-Library-APIs nutzen denselben Aufgabenablauf.
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,"status":"ACTIVE"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTypische Anwendungsfälle der Facebook Ad Library API
Beobachtung von Wettbewerber-Anzeigen
Verfolgen Sie öffentliche Anzeigen ausgewählter Seiten von Werbetreibenden und vergleichen Sie Creative, Medien, Auslieferungsstatus, Märkte, CTAs und Ziele im Zeitverlauf.
Recherche zu Creative und Botschaften
Durchsuchen Sie Begriffe zu Produkten, Kategorien oder Marken, um öffentliche Anzeigentexte, Formate, Medien, Handlungsaufforderungen und Zielseiten zu prüfen.
Entdeckung von Werbetreibenden
Lösen Sie Unternehmens- oder Markennamen in öffentliche Seiten-IDs und Identitätsfelder auf, bevor Sie eine gezielte seitenspezifische Anzeigenmenge erfassen.
Werbedatensätze
Speichern Sie normalisierte Anzeigen-IDs, Werbetreibenden-Datensätze, Creative-Felder, Auslieferungskontext, Quell-URLs und collected_at-Zeitstempel für Analysen.
Grenzen und Richtlinie für öffentliche Daten
Ergebnisse der Facebook Ad Library sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Diese APIs verwalten keine Werbekonten und liefern keine privaten Kampagnenleistungsdaten.
- Search erfordert genau eine nicht leere query; results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 20 bis 2.000.
- Company Search akzeptiert eine Abfrage nach Unternehmens- oder Seitennamen, akzeptiert kein results_limit und kann mehrere ähnlich benannte Seitenkandidaten liefern.
- Company Ads erfordert genau eine numerische Seiten-ID; results_limit akzeptiert 20 bis 2.000, und Filter können die Zahl der zurückgegebenen Datensätze verringern.
- Ad Details akzeptiert eine öffentliche URL facebook.com/ads/library mit numerischer id und liefert höchstens einen normalisierten Anzeigendatensatz.
- Eine abgeschlossene Aufgabe kann ohne Datensätze enden, wenn eine Anzeige, Seite oder gefilterte Ergebnismenge in der öffentlichen Quelle nicht verfügbar ist.
- Felder zu Reichweite, Ausgaben, Währung, Medien, Daten, CTA, Ziel und Werbetreibendem können fehlen und dürfen nicht als 0 gedeutet werden.
Häufige Fragen zur Facebook Ad Library API
Was ist die Facebook Ad Library API?
Die Facebook Ad Library API ist ein Satz von SocQ-Endpunkten zum Durchsuchen öffentlicher Anzeigen, Finden von Seiten von Werbetreibenden, Erfassen seitenspezifischer Anzeigen und Abrufen von Details zu bekannten öffentlichen Anzeigen.
Welche Facebook Ad Library API sollte ich verwenden?
Verwenden Sie Search für die Keyword-Suche, Company Search zum Finden einer Seiten-ID, Company Ads zum Erfassen der Anzeigen dieser ID und Ad Details für eine bekannte öffentliche Ad-Library-URL.
Was kann ich durchsuchen und filtern?
Search akzeptiert ein Keyword oder eine exakte Wortgruppe plus optionale Filter für Land, Status, Medien, Anzeigentyp, Datum, Sortierung und Ergebnislimit. Company Ads unterstützt seitenspezifische Filter für Auslieferung und Medien.
Welche öffentlichen Anzeigendaten werden zurückgegeben?
Ergebnisse können Identität von Anzeige und Werbetreibendem, Creative-Text, Bilder oder Videos, Auslieferungsdaten, aktiven Status, Publisher-Plattformen, Länder, CTA, Ziel und sichtbare öffentliche Signale enthalten.
Warum kann eine abgeschlossene Anfrage keine Ergebnisse liefern?
Die öffentliche Quelle hat möglicherweise keinen Treffer zur übermittelten Eingabe, Filter schließen möglicherweise alle Datensätze aus, oder die angeforderte Anzeige oder Seite ist möglicherweise nicht mehr öffentlich verfügbar.
Ist das dasselbe wie die Facebook-Social-Data-API oder die Marketplace-API?
Nein. Die Endpunkte der Facebook Ad Library sind getrennt von den Facebook-Seiten-, Beitrags- und Kommentar-APIs von SocQ sowie von den APIs für Facebook-Marketplace-Anzeigen.
Wie werden Ergebnisse der Facebook Ad Library abgerechnet?
Anzeigen aus Search, Kandidaten aus Company Search und Datensätze aus Company Ads kosten 0,5 Credits pro zurückgegebenem Ergebnis. Ad Details kostet 0,6 Credits pro zurückgegebenem Ergebnis, und leere Ergebnisse verursachen keine Ergebnisgebühr.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.
X API
Erfassen Sie öffentliche Profile, Follower- und Gefolgten-Beziehungen, Posts, Antworten, Zitat-Posts, Reposter, Suchergebnisse und aktuelle Trends. Nutzen Sie einheitliche Ergebnisse für Recherche und Monitoring.
LinkedIn API
Rufen Sie öffentliche LinkedIn-Daten zu Profilen, Unternehmen, Beiträgen und Jobs aus bekannten URLs ab – mit normalisierten Feldern zu Identität, Karriere, Unternehmen, Inhalt, Engagement und Jobs.
Reddit API
Rufen Sie öffentliche Reddit-Beiträge und -Kommentare aus bekannten URLs ab, durchsuchen Sie neue, beliebte oder aktuell angesagte Subreddit-Beiträge oder suchen Sie Diskussionen per Stichwort und Veröffentlichungszeitraum.
Pinterest API
Rufen Sie öffentliche Pinterest-Profildaten ab, lösen Sie bekannte Pins auf, erfassen Sie Pins ausgewählter Profile oder suchen Sie per Stichwort – für die Creator-Recherche sowie die Recherche zu Inhalten und visuellen Trends.
Threads API
Rufen Sie öffentliche Threads-Profile ab, lösen Sie bekannte Beiträge auf oder erfassen Sie Beiträge ausgewählter Profile – mit normalisierten Feldern zu Identität, Inhalt, Medien, Engagement und Zeitstempeln.
Bluesky API
Rufen Sie öffentliche Bluesky-Profile ab, lösen Sie URLs bekannter Beiträge auf oder erfassen Sie eine Seite mit Kontobeiträgen – mit normalisierter Identität, Inhalt, Medien, Zeitstempeln und sichtbaren Interaktionsfeldern.



