facebook-ad-library/
company-search

Öffentliche Seiten von Werbetreibenden in der Facebook Ad Library nach Unternehmens- oder Seitenname durchsuchen – mit Seiten-IDs, Kategorien, Bildern und Instagram-Publikumssignalen in normalisierten Datensätzen.

Facebook Ad Library Company Search API

Suche nach Unternehmen oder Seite
Kandidaten für Seiten von Werbetreibenden
Signale zu Seite und Instagram
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 Search

Unternehmenskandidaten der Facebook Ad Library sind Seiten von Werbetreibenden, die sich über Seiten-IDs, Namen, Kategorien, Länder, Bilder, Verifizierungswerte und verknüpften Instagram-Kontext erkennen lassen. Diese Signale zu Identität und Publikum unterstützen die Zuordnung von Werbetreibenden, den Vergleich gleichnamiger Seiten und eine nachvollziehbare Seitenauswahl vor der Anzeigenrecherche.

Funktionen der Facebook Ad Library Company Search API

  • Suche nach Unternehmen und SeitennamenSenden Sie eine nicht leere Suchanfrage mit Unternehmens-, Marken- oder Seitennamen und erhalten Sie alle Kandidaten für Seiten von Werbetreibenden, die für diese Abfrage zurückgegeben werden.
  • Seitenidentität und KlassifizierungLiefert Seiten-IDs, Namen, abgeleitete öffentliche URLs, Kategorien, Länder, Entitätstypen, Verifizierungswerte, Bilder und den Status „gelöschte Seite“, sofern verfügbar.
  • Sichtbare Signale zu Seite und InstagramBehält verfügbare Facebook-Likes zusammen mit verknüpften Instagram-Benutzernamen, Follower-Zahlen und Verifizierungsstatus in den normalisierten Kandidatendatensätzen bei.

Parameter der Facebook Ad Library Company Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Unternehmens-, Marken- oder öffentlicher Seitenname, mit dem Kandidaten für Seiten von Werbetreibenden gesucht werden.

So verwenden Sie die Facebook Ad Library Company Search API

Senden Sie eine Abfrage mit einem Unternehmens- oder Seitennamen, verfolgen Sie die asynchrone Aufgabe und prüfen Sie die normalisierten Kandidaten für Seiten von Werbetreibenden.

  1. Bereiten Sie eine nicht leere Abfrage mit einem Unternehmens-, Marken- oder öffentlichen Seitennamen vor.
  2. Senden Sie query per POST an /v1/facebook-ad-library/company-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 fordern Sie next_cursor an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

# 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 Search API

  • Ermittlung der Seiten-ID eines Werbetreibenden: Nutzen Sie Seiten-IDs, Namen, URLs, Kategorien und Länder der Kandidaten, um die Kennung auszuwählen, die für eine Company-Ads-Anfrage zu einer bestimmten Seite erforderlich ist.
  • Vergleich gleichnamiger und regionaler Seiten: Vergleichen Sie Kategorien, Länder, Entitätstypen, Bilder, Verifizierungswerte und verknüpften Instagram-Kontext über ähnlich benannte Werbetreibende hinweg.
  • Nachvollziehbare Auswahl von Werbetreibenden: Speichern Sie Seitenidentität, sichtbare Publikumssignale, ursprüngliche Abfrage und Erfassungszeit hinter einer Auswahl von Werbetreibenden oder einem Recherche-Index.

Profi-Tipps zur Facebook Ad Library Company Search API

  • Senden Sie nur query; results_limit sowie Filter für Anzeigenstatus, Land, Medien oder Zeitraum werden von Company Search nicht akzeptiert.
  • Wenn mehrere Kandidaten einen geläufigen Namen teilen, vergleichen Sie Seiten-ID, URL, Kategorie, Land, Bild, Verifizierung und verknüpfte Instagram-Identität, statt das erste Ergebnis zu wählen.
  • Folgen Sie next_cursor, bis has_more den Wert false hat, damit die Paginierung der Aufgabenergebnisse keinen gespeicherten Unternehmenskandidaten verdeckt.
  • Behandeln Sie Instagram-Identität, Follower-Zahlen, Verifizierungswerte, Bilder und den Status „gelöschte Seite“ als optionale Signale und gehen Sie mit fehlenden Feldern um, ohne den Kandidaten abzulehnen.

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

Facebook Ad Library Company Search API findet öffentliche Seiten von Werbetreibenden anhand eines nicht leeren Unternehmens- oder Seitennamens. Sie liefert Seiten-IDs, Felder zu Identität und Klassifizierung, Bilder, sichtbare Publikumskennzahlen und verknüpften Instagram-Kontext.

Der Endpunkt akzeptiert eine erforderliche, nicht leere Zeichenfolge query. results_limit sowie Filter für Land, Status, Medien, Sprache, Sortierung oder Zeitraum der Anzeigen werden nicht akzeptiert.

Nein. Der Endpunkt liefert Kandidaten für Seiten von Werbetreibenden und die numerische Seiten-ID, die Company Ads verwendet, aber keine Creatives und keine Auslieferungsdatensätze von Anzeigen.

Vergleichen Sie Seiten-ID, Name, URL, Kategorie, Land, Entitätstyp, Bild, Verifizierungswert und verknüpfte Instagram-Identität. Ein geläufiger Name allein belegt nicht, dass ein Kandidat der gemeinte Werbetreibende ist.

Die Unternehmenssuche akzeptiert kein results_limit und speichert jede eindeutige Seiten-ID, die für die Abfrage zurückgegeben wird. Eine abgeschlossene Aufgabe kann gespeicherte Datensätze dennoch mit next_cursor und has_more paginieren.

Ein leeres Array items bedeutet, dass die Abfrage keinen öffentlichen Seitenkandidaten geliefert hat. Unterschiede bei der Schreibweise oder die Verfügbarkeit der öffentlichen Quelle können ein leeres Ergebnis verursachen, es ist also kein Beweis, dass das Unternehmen keine Anzeigen hat.

Jeder zurückgegebene Unternehmenskandidat kostet 0,5 SocQ-Credits. Die Kostenschätzung der Anfrage geht von 10 Kandidaten aus, und eine leere Ergebnismenge verursacht nach der aktuellen Abrechnungskonfiguration keine Ergebnisgebühr.