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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, 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.
- Bereiten Sie eine nicht leere Abfrage mit einem Unternehmens-, Marken- oder öffentlichen Seitennamen vor.
- Senden Sie query per POST an /v1/facebook-ad-library/company-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 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 trueAnwendungsfä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.
Verwandte APIs
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.