facebook-ad-library/
company-ads

Öffentliche Anzeigen der Facebook Ad Library zu einer Seiten-ID eines Werbetreibenden abrufen – mit Creative-Text, Medien, Seitenkontext, Auslieferungsdetails und sichtbaren Signalen als normalisierte Datensätze.

Facebook Ad Library Company Ads API

Eingabe: Seiten-ID des Werbetreibenden
Creative- und Auslieferungskontext
Öffentliche Anzeigendatensätze
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 Company Ads

Company Ads der Facebook Ad Library sind öffentliche Datensätze eines Werbetreibenden mit Creative-Text, Medien, Seitenidentität, Auslieferungsdaten, Aktivstatus, Publisher-Plattformen, Länderkontext und sichtbaren Signalen. Diese Datensätze unterstützen die Beobachtung von Werbetreibenden, den Vergleich von Creatives, die marktspezifische Prüfung und das Reporting zum Erfassungszeitpunkt.

Funktionen der Facebook Ad Library Company Ads API

  • Erfassung für eine Seite des WerbetreibendenVerwenden Sie eine numerische Seiten-ID des Werbetreibenden, damit jede zurückgegebene Anzeige der ausgewählten öffentlichen Seite zugeordnet bleibt, statt aus einer Keyword-Suche zu stammen.
  • Markt- und AuslieferungsfilterGrenzen Sie die Erfassung nach Land, Auslieferungsstatus, Medientyp, Sprache, Zeitraum und unterstützter Sortierung ein, bevor die Datensätze gespeichert werden.
  • Felder zu Creative, Medien und ZielLiefert für jede Anzeige verfügbare Titel, Fließtexte, Bilder oder Videos, CTA-Werte, öffentliche Ziel-URLs und Anzeigeformate.
  • Kontext des Werbetreibenden und der AuslieferungBehält Seitenidentität, Seiten-Likes, Auslieferungsdaten, Aktivstatus, Publisher-Plattformen, Länder, Reichweite, Währung und Ausgaben bei, sofern sie öffentlich sichtbar sind.
  • Begrenzte, eindeutige AnzeigendatensätzeFolgt den verfügbaren Quellseiten, entfernt doppelte Archiv-IDs oder URLs und stoppt bei results_limit oder auf der letzten verfügbaren Seite.

Parameter der Facebook Ad Library Company Ads API

ParameterErforderlichBeschreibung
page_idErforderlichErforderliche numerische Seiten-ID eines Werbetreibenden in der Facebook Ad Library. Nutzen Sie zuerst Company Search, wenn die Seiten-ID unbekannt ist; eine Aufgabe akzeptiert eine Seiten-ID.
results_limitOptionalMaximale Anzahl eindeutiger Anzeigen, die gespeichert werden. Der Standardwert ist 100, zulässig sind ganze Zahlen von 20 bis 2.000.
countryOptionalVerwenden Sie ALL oder einen zweistelligen Ländercode. Der Standardwert ist ALL.
statusOptionalFilter für den Auslieferungsstatus der Anzeige. Verwenden Sie genau ALL, ACTIVE oder INACTIVE; der Standardwert ist ACTIVE.
media_typeOptionalFilter für den Medientyp des Creatives. Verwenden Sie genau ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME oder NONE; der Standardwert ist ALL.
languageOptionalOptionaler zweistelliger Sprachcode der Anzeige.
sort_byOptionalSortiert die zurückgegebenen Anzeigen nach total_impressions oder relevancy_monthly_grouped; der Standardwert ist total_impressions.
start_dateOptionalOptionales Startdatum im Format YYYY-MM-DD. Es darf nicht nach end_date liegen.
end_dateOptionalOptionales Enddatum im Format YYYY-MM-DD. Es darf nicht vor start_date liegen.

So verwenden Sie die Facebook Ad Library Company Ads API

Senden Sie eine Seiten-ID eines Werbetreibenden mit optionalen Filtern, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Anzeigendatensätze per Cursor-Paginierung.

  1. Ermitteln Sie die numerische Seiten-ID des Werbetreibenden und wählen Sie bei Bedarf Filter für Land, Status, Medien, Sprache, Sortierung oder Zeitraum.
  2. Senden Sie page_id und die gewählten Filter an /v1/facebook-ad-library/company-ads und notieren Sie die task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie mit next_cursor die nächste Seite an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'

# 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 Company Ads API

  • Beobachtung der Anzeigen eines Werbetreibenden: Verfolgen Sie Archiv-IDs, Creative-Text, Medien, Aktivstatus, Auslieferungsdaten, Quell-URLs und collected_at für die Seite eines bekannten Werbetreibenden.
  • Vergleich von Creatives und Formaten: Vergleichen Sie Text, Bilder oder Videos, Anzeigeformat, CTA, Ziellinks und Collation-Kontext über die zurückgegebenen Anzeigen der Seite hinweg.
  • Marktbezogene Anzeigenprüfung: Wenden Sie Filter für Land, Sprache, Status, Medien und Zeitraum an, um getrennte Anzeigengruppen für definierte Markt- oder Auslieferungsfragen aufzubauen.
  • Berichte mit Momentaufnahmen öffentlicher Signale: Kombinieren Sie Seitenidentität, Seiten-Likes, Reichweite, Ausgaben, Währung, Auslieferungsstatus und collected_at, sofern diese öffentlichen Werte sichtbar sind.

Profi-Tipps zur Facebook Ad Library Company Ads API

  • Beginnen Sie mit country auf ALL sowie breiten Medien- und Zeitraumfiltern und engen Sie dann eine Bedingung nach der anderen ein, damit sich ein leeres Ergebnis richtig deuten lässt.
  • Nutzen Sie den Mindestwert 20 für results_limit, solange Sie eine Seiten-ID und einen Filtersatz prüfen, und erhöhen Sie ihn erst, wenn der zurückgegebene Umfang zur Aufgabe passt.
  • Senden Sie für Marken mit mehreren Seiten-IDs von Werbetreibenden getrennte Aufgaben, denn eine Company-Ads-Anfrage akzeptiert eine Seiten-ID.
  • Deduplizieren Sie wiederholte Läufe anhand der Anzeigen-ID, behandeln Sie fehlende Werte zu Reichweite, Ausgaben, Medien und Daten als nicht verfügbar statt als 0 und nutzen Sie die Collation-Felder zur Gruppierung, nicht für Aussagen zur Leistung.

Ergänzend zur Facebook Ad Library Company Ads 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 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 Company Ads API — FAQ

Facebook Ad Library Company Ads API ruft öffentliche Anzeigen zu einer numerischen Seiten-ID eines Werbetreibenden ab. Sie liefert normalisierte Felder zu Creative, Medien, Werbetreibendem, Auslieferung, Markt, CTA, sichtbaren Signalen und Erfassungszeitpunkt.

Nutzen Sie Facebook Ad Library Company Search mit dem Namen des Unternehmens oder der Marke und wählen Sie aus den zurückgegebenen Kandidaten die richtige numerische Seiten-ID, bevor Sie Company Ads senden.

Sie können nach Land, Auslieferungsstatus, Medientyp, zweistelligem Sprachcode sowie Start- und Enddatum filtern und eine der zwei unterstützten Sortierungen wählen. results_limit legt fest, wie viele eindeutige Anzeigen höchstens gespeichert werden.

Die gewählte Seite hat möglicherweise keine öffentlich verfügbaren Anzeigen, die zu den Filtern für Land, Status, Medien, Sprache oder Zeitraum passen, oder es ist keine weitere Quellseite verfügbar. Ein erfolgreiches leeres Ergebnis erzeugt keine Platzhalter-Anzeigen.

Jeder zurückgegebene Anzeigendatensatz kostet 0,5 SocQ-Credits. Für eine leere Ergebnismenge fällt keine Ergebnisgebühr an.