google-ad-library/
company-ads

Gefilterte öffentliche Creative-Datensätze aus dem Google Ads Transparency Center anhand von Werbetreibenden-ID oder Domain auflisten – mit normalisierter Creative-Identität, Quell-URL, Ausspielung, Format und verfügbaren Detailfeldern.

Google Ad Library Company Ads API

Bestand eines Werbetreibenden
Paginierung mit 40 Datensätzen
Filterbarer Creative-Index
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

Google Ad Library Company Ads

Der Creative-Bestand im Google Ads Transparency Center lässt sich über eine ausgewählte ID eines Werbetreibenden oder eine Unternehmensdomain auflisten und mit öffentlichen Abfragefiltern eingrenzen. Creative-Kennungen und Quell-URLs sind die verlässlichsten Werte auf Listenebene, da die Anreicherung mit Details pro Anzeige für diese Operation deaktiviert ist.

Funktionen der Google Ad Library Company Ads API

  • Ausgangspunkt Werbetreibender oder DomainGeben Sie mindestens eine Google-ID eines Werbetreibenden oder eine Unternehmensdomain an; sind beide vorhanden, bestimmt die vorgelagerte Quelle, wie sie sich überschneiden.
  • Validierte BestandsfilterGrenzen Sie den öffentlichen Creative-Index nach Thema, Region, Zeitfenster, Google-Plattform oder den Formatwerten Text, Bild und Video ein.
  • Cursorbasierte ErfassungFolgt den Cursorn des Anbieters in Seiten mit 40 Datensätzen und stoppt beim angeforderten Ergebnislimit von 40 bis 2.000, auf der letzten Seite, bei einer leeren Seite oder bei einem ungültigen wiederholten Cursor.
  • Stabile AnzeigendatensätzeLiefert das gemeinsame normalisierte Anzeigenschema und behält Null- und leere Detailfelder auf Listenebene bei, statt Creative-Anreicherung zu erfinden.

Parameter der Google Ad Library Company Ads API

ParameterErforderlichBeschreibung
domainErforderlich (mindestens eines)Website-Domain des Unternehmens, zum Beispiel lululemon.com. Mindestens einer der Parameter domain oder advertiser_id ist erforderlich; der Abgleich über die Domain kann mehr als einen Datensatz eines Werbetreibenden umfassen.
advertiser_idErforderlich (mindestens eines)Kennung eines Werbetreibenden im Google Transparency Center, die in der Regel mit AR beginnt. Mindestens einer der Parameter advertiser_id oder domain ist erforderlich.
topicOptionalOptionaler öffentlicher Themenfilter der Quelle: all oder political. Verhalten und Abdeckung des Filters werden von der Quelle bestimmt.
regionOptionalOptionaler Regionscode wie US, der als öffentlicher Abfragekontext und nicht als vollständige Targeting-Definition weitergegeben wird.
start_dateOptionalOptionaler Datumsfilter der Quelle, inklusive Startdatum, im Format YYYY-MM-DD. Er darf nicht nach end_date liegen, wenn beide Daten angegeben werden.
end_dateOptionalOptionaler Datumsfilter der Quelle im Format YYYY-MM-DD. Er darf nicht vor start_date liegen, wenn beide Daten angegeben werden.
platformOptionalOptionale Google-Plattform: google_maps, google_play, google_search, google_shopping oder youtube.
formatOptionalOptionales Creative-Format: text, image oder video. Ähnliche Creative-Varianten können dennoch als getrennte Datensätze erscheinen.
results_limitOptionalMaximale Anzahl gespeicherter Creative-Datensätze. Standardwert ist 40; zulässig sind ganze Zahlen von 40 bis 2.000 in Vielfachen von 40.

So verwenden Sie die Google Ad Library Company Ads API

Senden Sie eine strukturierte Anfrage zum Bestand eines Werbetreibenden, verfolgen Sie die asynchrone Aufgabe und nutzen Sie die zurückgegebenen Creative-URLs für den gezielten Abruf von Details.

  1. Wählen Sie eine advertiser_id oder domain; fügen Sie nur Filter hinzu, die zur Vergleichs- oder Erfassungsfrage gehören.
  2. Setzen Sie results_limit auf 40 bis 2.000 in Vielfachen von 40 und senden Sie die Anfrage per POST an /v1/google-ad-library/company-ads.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt, und blättern Sie bei Bedarf durch die gespeicherten Aufgabenergebnisse.
  4. Behandeln Sie IDs und Creative-URLs als Indexdatensätze; senden Sie ausgewählte URLs an die separate Operation für Anzeigendetails, wenn Sie umfangreichere Felder benötigen.
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"AR01614014350098432001","region":"US","format":"video","results_limit":80}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and select creative URLs for detail retrieval

Anwendungsfälle der Google Ad Library Company Ads API

  • Eine gezielte Warteschlange für Details aufbauen: Listen Sie Creative-IDs und öffentliche URLs eines Werbetreibenden auf und wählen Sie dann nur die relevanten Datensätze für umfangreichere Detailanfragen aus.
  • Beobachtbare Formatmischungen vergleichen: Zählen Sie die zurückgegebenen Indexdatensätze für Text, Bild und Video bei gleichbleibenden Kennungen, Filtern, Limits und Erfassungszeiträumen.
  • Offengelegte Ausspielungszeiträume prüfen: Erkennen Sie Creative-Datensätze, die unter vergleichbaren Filtern für Datum, Region, Thema oder Google-Plattform zurückgegeben wurden, ohne sie als private Targeting-Daten zu behandeln.

Profi-Tipps zur Google Ad Library Company Ads API

  • Bevorzugen Sie eine geprüfte advertiser_id gegenüber einer breiten Domain, wenn die gemeinte Einheit im Transparency Center bereits bekannt ist.
  • Halten Sie Kennungen, Filter, results_limit und Erfassungsdaten konsistent, wenn Sie Creative-Bestände im Zeitverlauf vergleichen.
  • Rechnen Sie damit, dass Text, Datumsangaben, Ziel, Impressionen und Medien auf Listenebene null oder leer sind, weil get_ad_details immer false ist.
  • Werten Sie ein erfolgreiches leeres Ergebnis als „kein verwertbares Creative zu den übergebenen Kennungen und Filtern zu diesem Zeitpunkt“ und nicht als Beweis, dass das Unternehmen nie geworben hat.

Ergänzend zur Google Ad Library Company Ads API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Ad Library-Daten benötigen.

  • Google Ad Library Ad API — Ein bekanntes öffentliches Creative des Transparency Centers über die URL abrufen – mit Feldern zu Werbetreibendem, Text, Medien, Auslieferung, Region, Format, Ziel und Impressionen.
  • Google Ad Library Advertiser Search API — Öffentliche Werbetreibende im Transparency Center per Suchanfrage und optionaler Region ermitteln – mit Feldern zu Identität, Website, Logo, Region und verfügbarer Anzahl der Anzeigen.

Weitere Plattformen entdecken

Kombinieren Sie Google Ad Library-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Ad Library Company Ads API — FAQ

Google Ad Library Company Ads API ist eine Schnittstelle zum Auflisten öffentlicher Creative-Indexdatensätze aus dem Google Ads Transparency Center anhand von Werbetreibenden-ID oder Domain und optionalen Filtern. Sie liefert normalisierte Anzeigendatensätze, wobei Creative-IDs und öffentliche URLs in der Regel verlässlicher sind als Detailfelder.

Mindestens eines von beiden ist erforderlich. Eine ID des Werbetreibenden ist normalerweise präziser, während eine Domain Datensätze mehrerer öffentlicher Einheiten von Werbetreibenden treffen kann; geben Sie beide an, werden beide Werte zusammen weitergegeben.

Der Standardwert ist 40, zulässig sind ganze Zahlen von 40 bis 2.000 in Vielfachen von 40. SocQ folgt den Cursorn des Anbieters und kürzt die gespeicherten Zeilen auf dieses Limit.

Die Listenanfrage sendet immer get_ad_details=false. Die Felder des stabilen Schemas bleiben deklariert, aber fehlende Werte für Text, Medien, Ziel, Ausspielung oder Impressionen werden nicht abgeleitet.

Jeder gespeicherte Creative-Datensatz kostet 0,5 SocQ-Credits. Die Schätzung geht von 40 Ergebnissen aus und erlaubt eine Überschreitung; ein erfolgreiches leeres Ergebnis verursacht nur die konfigurierte Grundgebühr von null Credits.