google-ad-library/
advertiser-search

Öffentliche Werbetreibende aus dem Google Ads Transparency Center über eine Suchanfrage und optional eine Region finden – mit normalisierten Feldern zu Identität, Website, Logo, Region und verfügbarer Anzeigenzahl.

Google Ad Library Advertiser Search API

Kandidaten unter den Werbetreibenden
Optionaler Regionskontext
Stabile Identitätsfelder
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 Advertiser Search

Das Google Ads Transparency Center kann zu einer Marke, einer Organisation oder einem Website-Suchbegriff mehrere Datensätze von Werbetreibenden anzeigen, auch regionale oder ähnlich benannte Einheiten. Die Prüfung von IDs, Namen, Websites, Logos, Regionen und verfügbaren Anzeigenzahlen hilft, den richtigen öffentlichen Datensatz auszuwählen, bevor Sie dessen Creatives sammeln.

Funktionen der Google Ad Library Advertiser Search API

  • Entdeckung von Werbetreibenden über den NamenSuchen Sie mit einem nicht leeren Begriff für eine Marke, Organisation, einen Werbetreibenden oder eine Website und erhalten Sie normalisierte Kandidaten unter den Werbetreibenden statt Anzeigen-Creatives.
  • Optionaler RegionskontextÜbergeben Sie eine Region wie US, um die vorgelagerte Suche einzuordnen, wobei die Region von der Ausspielungsgeografie der Anzeigen getrennt bleibt.
  • Identitätsfelder der KandidatenVergleichen Sie die öffentliche ID des Werbetreibenden, Namen, URL, Website, Logo, Region und die von der Quelle gemeldete Anzeigenzahl, sofern verfügbar, ganz ohne abgeleitete Anreicherung.
  • Vollständige Speicherung einer einzelnen AntwortSpeichert jeden verwertbaren Werbetreibenden aus der einen vorgelagerten Suchantwort; es gibt weder ein vom Aufrufer steuerbares Ergebnislimit noch eine Paginierungsschleife beim Anbieter.

Parameter der Google Ad Library Advertiser Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Suchbegriff für einen Werbetreibenden, eine Marke, eine Organisation oder eine Website. Das Suchverhalten hängt von der Quelle ab; ein exakter, Präfix- oder unscharfer Abgleich ist nicht garantiert.
regionOptionalOptionale, nicht leere Regionszeichenfolge wie US, die als geografischer Suchkontext weitergegeben wird. Sie belegt nicht, wo die Anzeigen eines Werbetreibenden ausgespielt wurden.

So verwenden Sie die Google Ad Library Advertiser Search API

Senden Sie einen Suchbegriff, verfolgen Sie die asynchrone Aufgabe und prüfen Sie jeden normalisierten Kandidaten, bevor Sie dessen Identität in der weiteren Recherche verwenden.

  1. Wählen Sie einen konkreten Begriff für einen Werbetreibenden, eine Marke, eine Organisation oder eine Website; fügen Sie optional eine Region wie US hinzu.
  2. Senden Sie query und optional region per POST an /v1/google-ad-library/advertiser-search und speichern Sie task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
  4. Lesen Sie data.results.items und prüfen Sie die Identität der Kandidaten anhand von mehr als der Namensähnlichkeit, bevor Sie eine ID des Werbetreibenden auswählen.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Nike","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidates

Anwendungsfälle der Google Ad Library Advertiser Search API

  • Eine Marke den IDs von Werbetreibenden zuordnen: Erstellen Sie aus einem Namen oder Website-Begriff eine Kandidatenliste, bevor Sie eine ID des Werbetreibenden für eine separate Abfrage des öffentlichen Anzeigenbestands auswählen.
  • Regionale oder rechtliche Einheiten trennen: Vergleichen Sie Namen, Regionen, Websites und öffentliche Seiten der Werbetreibenden, wenn mehrere ähnliche Datensätze Tochtergesellschaften, Wiederverkäufer oder unabhängige Organisationen darstellen können.
  • Eine Prüfwarteschlange aufbauen: Speichern Sie Identitäten der Kandidaten und Erfassungszeitstempel für die manuelle Prüfung, ohne allein aus der Namensähnlichkeit auf Eigentumsverhältnisse zu schließen.

Profi-Tipps zur Google Ad Library Advertiser Search API

  • Verwenden Sie einen konkreten Firmennamen, eine Marke oder einen domainähnlichen Begriff; allgemeine Formulierungen können mehrdeutige Kandidaten liefern, und die Abgleichregeln sind nicht garantiert.
  • Behandeln Sie region als Suchkontext und nicht als Beleg dafür, dass jede Anzeige des Werbetreibenden in dieser Geografie lief.
  • Prüfen Sie Kandidaten anhand von ID, Name, Website, Region und der öffentlichen Seite des Werbetreibenden, bevor Sie Datensätze zusammenführen oder Creatives sammeln.
  • Senden Sie kein results_limit: Diese Operation speichert das verwertbare Array der Werbetreibenden aus einer vorgelagerten Antwort und paginiert die Quelle nicht.

Ergänzend zur Google Ad Library Advertiser Search 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 Company Ads API — Öffentliche Creatives des Transparency Centers über Unternehmensdomain oder ID des Werbetreibenden erfassen – mit Optionen für Thema, Region, Datum, Ausspielfläche, Format und Ergebnislimit.

Weitere Plattformen entdecken

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

Google Ad Library Advertiser Search API — FAQ

Google Ad Library Advertiser Search API ist eine Schnittstelle zum Finden öffentlicher Werbetreibender aus dem Google Ads Transparency Center anhand einer Suchanfrage und optional einer Region. Sie liefert normalisierte Identitätsdaten der Werbetreibenden sowie quellenabhängige Felder zu Website, Logo, Region und Anzeigenzahl, aber keine Anzeigen-Creatives.

Sie liefert ausschließlich Kandidaten unter den Werbetreibenden. Nutzen Sie eine geprüfte ID des Werbetreibenden oder eine Domain mit der separaten Operation Company Ads, um öffentliche Creatives aufzulisten.

Die Region ist geografischer Kontext, der an die Suche nach Werbetreibenden weitergegeben wird. Sie kann helfen, die Kandidaten einzugrenzen, ist aber weder ein garantiert exakter Filter noch ein Beleg für die Ausspielungsgeografie der Anzeigen.

Nein. Es ist das vollständige verwertbare Array der Werbetreibenden aus einer vorgelagerten Suchantwort zum Zeitpunkt der Erfassung, ohne Paginierungsschleife von SocQ und ohne vom Aufrufer steuerbares Limit.

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