Facebook (Meta) Anzeigenbibliothek API nutzen: Anleitung

Die Facebook/Meta Werbebibliothek API, die wir als die Facebook Ad Library API bezeichnen, ist eine öffentlich zugängliche Schnittstelle, die Entwicklern Zugriff auf auf Facebook, Instagram und anderen Meta-eigenen Plattformen (z.B. WhatsApp und Threads) veröffentlichte Anzeigen bietet. Über diese API können Sie Anzeigen nach einem Stichwort, einer Seiten-ID, einem Land oder einem Anzeigentyp suchen und Metadaten wie Anzeigen-Creatives, Ausgabenbereiche, Impressionen, Publisher-Plattformen und vieles mehr abrufen.

Diese API ist besonders nützlich für Transparenzforschung, Marketing-Audits, Wettbewerbsanalysen, die Analyse von Anzeigen-Creatives oder den Aufbau von Tools rund um Social-Media-Anzeigendaten. Egal, ob Sie aktive Anzeigen überwachen, politische oder sozial relevante Anzeigen (SIEP-Anzeigen) untersuchen oder Marketingstrategien analysieren möchten, die Facebook Ad Library API öffnet eine mächtige Tür zu Anzeigendaten.

Warum die Facebook Ad Library API nutzen und was können Sie damit tun?

Einige der wichtigsten Funktionen der Facebook Ad Library API:

1. Suche nach Stichwörtern, Seiten-IDs, Land, Anzeigentyp – Sie können Anzeigen nach ihrem Inhalt, dem Schalter, dem Ausführungsort und der Kampagnenart eingrenzen.
2. Filtern nach Status: aktiv/inaktiv, Ausgabenbereiche, Impressionen – hilfreich, wenn Sie nur aktuell laufende Anzeigen oder solche ober-/unterhalb bestimmter Ausgabenschwellenwerte wünschen.
3. Abrufen von Anzeigen-Metadaten – einschließlich Feldern wie page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram) und mehr.
4. Unterstützung für langfristige und breite Datenabdeckung – zum Beispiel weltweit für SIEP-Anzeigen und für viele Regionen für allgemeine Anzeigen (vorbehaltlich der Meta-Regionenrichtlinien ab 2025).
5. Kostenloser Zugriff auf öffentliche Daten – keine Vorabkosten für das Abrufen öffentlicher Anzeigendaten, solange Sie die entsprechende Zugriffseinrichtung haben.

Kurz gesagt – die API bietet eine strukturierte, programmierbare Möglichkeit, Anzeigendaten in großem Maßstab zu erkunden und zu sammeln.

Schritt-für-Schritt-Anleitung: Wie Sie mit der Facebook Ad Library API beginnen

Schritt 1: Bestätigen Sie Ihre Facebook/Meta Kontoidentität

• Melden Sie sich bei Ihrem Facebook-Konto (persönlich oder geschäftlich) an oder erstellen Sie eines.
• Stellen Sie sicher, dass Ihr Konto verifiziert ist (Meta erfordert manchmal eine Identitätsprüfung für den API-Zugriff). (Kontoverifizierung)
• Dieser Schritt ist besonders wichtig, wenn Sie den Zugriff auf Ad-Library-Daten über eine App beantragen möchten.

Schritt 2: Registrieren Sie eine Meta Developer App

• Besuchen Sie Meta for Developers → „Erste Schritte“ und melden Sie sich auf der Plattform an. (Hier klicken)

• Erstellen Sie eine neue App: Wählen Sie „Andere“ oder einen generischen Typ, wenn Sie nicht werben.

• Wählen Sie aus, dass Sie Zugriff auf Marketing-APIs / Ad-Library wünschen.

• Anfänglich befindet sich die App im Entwicklungsmodus – dies ist ausreichend für grundlegende Tests und den Einsatz in kleinem Umfang.

Schritt 3: Generieren Sie ein Zugriffstoken

• Verwenden Sie den Graph API Explorer oder die Tools von Meta, um ein Benutzerzugriffstoken zu generieren.
• Stellen Sie sicher, dass das Token die erforderlichen Berechtigungen besitzt (z.B. ads_read, möglicherweise ads_archive oder andere, je nach den Anforderungen von Meta). (Facebook for Developers)

Hinweis: Zugriffstoken laufen ab; Sie müssen sie möglicherweise verlängern oder langlebige Token generieren, je nach Ihrer Nutzung.

Schritt 4: Machen Sie Ihren ersten API-Aufruf

Sie können den Endpunkt /ads_archive (die Wurzel der Ad Library API) abfragen. Verwenden Sie die neueste API-Version (z.B. v23.0 oder neuer). (Facebook for Developers)

Beispiel: mit curl

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

Beispiel: mit JavaScript (fetch)

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

Die JSON-Antwort enthält ein Array von Anzeigenobjekten, jedes mit Metadaten wie page_name, ad_snapshot_url, Ausgabenbereichen, Impressionenbereichen, Publisher-Plattformen und möglicherweise weiteren Feldern.

Schritt 5: Umgang mit Paginierung & großen Ergebnissen

Da die Ad Library viele Ergebnisse zurückgeben kann, verwendet die API Paginierung. Seien Sie darauf vorbereitet, nachfolgende Seiten zu durchlaufen – prüfen Sie die Antwort auf paging- oder Cursor-Token und iterieren Sie entsprechend. Entwickler erstellen oft Schleifen im Code, um große Ergebnismengen zu aggregieren.

Schritt 6: Anwendungsfälle – Was Sie mit diesen Daten tun können?

Hier sind häufige Anwendungsfälle:

1. Wettbewerbsanalyse – Abrufen von Anzeigen von der Facebook-Seite eines Konkurrenten (über Seiten-ID), um deren Kreatives, geschätzte Ausgaben oder Zielgruppenreichweite zu untersuchen.
2. Trendüberwachung & Forschung – Verfolgen, welche Arten von Anzeigen nach Stichwort, Region, Medientyp oder Anzeigentyp (z.B. politisch, Wohnen, soziale Themen) aktiv sind.
3. Marketing-Intelligence-Dashboards – Aggregieren von Daten (Ausgabenbereiche, Impressionen, Anzeigenfrequenz) und Visualisierung über die Zeit oder über Regionen hinweg.
4. Anzeigen-Creative-Analyse / Inspiration – Abrufen und Archivieren von Anzeigen-Creatives (Bild-/Video-URLs) zur Produktinspiration oder für Compliance-Audits.
5. Akademische / Transparenzforschung – Verwendung von Anzeigendaten für Studien zu politischer Werbung, Social-Issue-Kampagnen oder Markttrends.

Diese Anwendungsfälle verdeutlichen den Wert eines strukturierten, programmatischen Zugriffs auf Anzeigendaten.

Testen der Facebook Ad Library API mit Apidog

Verwenden Sie Apidog als Testumgebung für die Facebook Ad Library API. So beginnen Sie mit dem Testen Ihrer APIs in Apidog:

1. In Apidog erstellen Sie einen neuen API-Endpunkt: Methode auf GET setzen, URL auf https://graph.facebook.com/v23.0/ads_archive.

2. Unter den Abfrageparametern fügen Sie Parameter wie search_terms, ad_reached_countries, fields und access_token hinzu.

3. Klicken Sie auf „Senden“ – Apidog ruft die Daten ab und zeigt Ihnen die JSON-Antwort in strukturierter Form an.

4. Sie können mit verschiedenen Parameterkombinationen experimentieren, die Paginierung testen und sogar Beispielantworten zur Dokumentation oder Analyse speichern.

Dieser Ansatz ist besonders nützlich für die schnelle Erkundung von Anzeigendaten, das Testen von Suchanfragen und das Erstellen von Integrationen, ohne vollständigen Code schreiben zu müssen.

Häufig gestellte Fragen

F1. Benötige ich ein spezielles Werbekonto oder Geschäftskonto, um die Facebook Ad Library API zu nutzen?
Nein – ein verifiziertes Meta-Konto ist in der Regel ausreichend. Sie müssen jedoch eine Meta Developer App registrieren und ein Zugriffstoken mit den entsprechenden Berechtigungen (z.B. ads_read, ads_archive) erhalten. Einige Benutzer müssen zur vollständigen Freischaltung eine Identitätsprüfung abschließen.

F2. Kann ich Daten für beliebige Anzeigen abrufen (nicht nur für politische oder sozial relevante Anzeigen)?
Ja – die API unterstützt allgemeine Anzeigen (nicht nur SIEP). Sie können je nach Region und Anzeigenverfügbarkeit ad_type=all (oder den Filter weglassen) verwenden.

F3. Wie viele Anzeigen kann ich in einer einzigen Anfrage abrufen?
Standardmäßig gibt die API eine begrenzte Anzahl von Anzeigen pro Anfrage zurück (Paginierung). Um mehr abzurufen, müssen Sie die Seiten mithilfe des in der Antwort bereitgestellten Paging-Cursors durchlaufen.

F4. Kann ich über die API auf Anzeigen-Creatives (Bilder, Videos) zugreifen?
Sie erhalten ad_snapshot_url oder ähnliche Felder, die auf die Creative-Vorschau der Anzeige verlinken. Meta stellt jedoch nicht immer direkte Mediendateien bereit – das Abrufen tatsächlicher Bilder oder Videos kann zusätzliche Schritte erfordern.

F5. Gibt es eine Möglichkeit, den Datenabruf zu automatisieren und Probleme mit ablaufenden Tokens zu vermeiden?
Ja – Sie können langlebige Tokens in den Meta-Entwicklertools generieren oder ein Backend-System einrichten, das Tokens regelmäßig aktualisiert. Für den groß angelegten Datenabruf ist die Kombination von Token-Management mit Paginierungsschleifen üblich. Speichern Sie Tokens immer sicher.

Fazit

Die Facebook (Meta) Ad Library API bietet ein leistungsstarkes, strukturiertes Gateway zu Anzeigendaten – das es Entwicklern, Vermarktern, Forschern und Analysten ermöglicht, Anzeigenkampagnen auf Metas Plattformen programmatisch zu suchen, zu sammeln und zu analysieren. Damit können Sie Dashboards erstellen, Wettbewerbsanalysen durchführen, Transparenzforschung betreiben oder Anzeigen-Creatives in großem Maßstab aggregieren.

Durch die Einrichtung einer Meta Developer App, den Erwerb eines geeigneten Zugriffstokens und das Stellen von Anfragen an den /ads_archive-Endpunkt – optional getestet mit Tools wie Apidog – können Sie eine Fülle von Ad-Library-Daten erschließen. Obwohl es Einschränkungen gibt (Berechtigungen, Ratenbegrenzungen, Paginierung, Medienabruf), überwiegen die Vorteile oft den Aufwand.

Für alle, die öffentliche Anzeigendaten von Facebook/Meta benötigen, ist die Ad Library API eine wertvolle, offizielle und flexible Option.