Zurück zu den APIs
Unabhängige Transparenzdaten zu öffentlicher Werbung

Google Ad Library API

Finden Sie öffentliche Werbetreibende, erfassen Sie die Creatives eines Unternehmens oder rufen Sie ein bekanntes Creative aus dem Transparency Center per URL ab – für Recherche und Prüfung.

Verfügbare Google-Ad-Library-APIs

Mit Advertiser Search finden Sie passende Kandidaten, mit Company Ads erfassen Sie begrenzte Mengen an Creatives, und mit Ad Details lösen Sie genau eine öffentliche Creative-URL auf.

Welche Google-Transparenzdaten zu Anzeigen können Sie abrufen?

SocQ normalisiert die verfügbaren öffentlichen Felder des Transparency Center und behält nicht verfügbare Quellwerte als null oder leer bei.

Suche nach Werbetreibenden

Findet per Suchbegriff Identitäten möglicher Werbetreibender, Websites, Logos, Regionen und verfügbare Felder zur Anzahl der Anzeigen.

Creative- und Zielkontext

Erfasst verfügbare Texte, Verweise auf Werbetreibende, Formate, Medienelemente und Ziele der Landingpages.

Öffentlicher Auslieferungskontext

Behält verfügbare Daten, Länder, Google-Oberflächen und sicher normalisierte Impressionswerte bei.

SocQ und Google-Ads-Produkte

SocQ normalisiert unterstützte öffentliche Transparenzdatensätze. Für autorisierte Konto- und Kampagnenverwaltung bleiben Google-Ads-Produkte die richtige Wahl.

FunktionSocQGoogle-Ads-Produkte
HauptzweckÖffentliche Transparenzdatensätze finden und normalisierenAutorisierte Werbekonten und Kampagnen verwalten
EingabenSuchbegriff, Unternehmenskennung und Filter oder genaue Creative-URLProduktspezifische Eingaben zu Konto, Kampagne oder Reporting
AuthentifizierungSocQ-API-SchlüsselProduktspezifische Google-Zugangsdaten und Autorisierung
AntwortformatNormalisierte Datensätze zu öffentlichen Werbetreibenden und AnzeigenProduktspezifische native Antwort

So funktionieren die Google-Ad-Library-APIs

Alle drei Endpunkte nutzen den asynchronen SocQ-Ablauf aus Senden, Abfragen und Lesen der Ergebnisse.

  1. 1. Endpunkt wählen

    Senden Sie eine Abfrage an Advertiser Search, eine Domain oder Werbetreibenden-ID an Company Ads oder eine Creative-URL an Ad Details.

  2. 2. Aufgabe senden und verfolgen

    Senden Sie die Anfrage per POST, speichern Sie task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Normalisierte Ergebnisse lesen

    Verarbeiten Sie data.results.items; Company Ads beachtet die angeforderte Obergrenze, Ad Details liefert höchstens ein Element.

Öffentliche Anzeigen eines Unternehmens erfassen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel und geben Sie entweder eine Unternehmens-Domain oder eine Werbetreibenden-ID an. Die Standardobergrenze für Ergebnisse beträgt 40.

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 '{"domain":"lululemon.com","results_limit":40}'

# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}

Typische Anwendungsfälle der Google Ad Library API

Suche nach Werbetreibenden

Wandeln Sie eine Marken- oder Website-Abfrage in öffentliche Kandidaten für Werbetreibende um, bevor Sie Anzeigen erfassen.

Recherche zu Unternehmens-Creatives

Erfassen Sie begrenzte Mengen öffentlicher Creatives mit optionalen Filtern für Thema, Region, Datum, Oberfläche und Format.

Anreicherung ausgewählter Creatives

Vervollständigen Sie einen bekannten Creative-Datensatz um Felder zu Werbetreibendem, Text, Medien, Ziel und Auslieferung.

Grenzen und Richtlinie für öffentliche Daten

Die Ergebnisse hängen von der aktuellen Sichtbarkeit der öffentlichen Quelle ab und enthalten keine privaten Daten aus Google-Ads-Konten.

  • Advertiser Search erfordert eine Abfrage und akzeptiert optional eine Region; es gibt keine Eingabe results_limit.
  • Company Ads erfordert domain oder advertiser_id und akzeptiert results_limit in Vielfachen von 40 von 40 bis 2.000.
  • Ad Details erfordert eine adstransparency.google.com-URL, deren Pfad /creative/ enthält, und liefert höchstens ein Element.
  • Öffentliche Datensätze können unvollständig sein und enthalten keine privaten Budgets, Klicks, Conversions, Gebote, Zielgruppen oder Werbekostenrenditen.

Häufige Fragen zur Google Ad Library API

Welchen Endpunkt sollte ich zuerst verwenden?

Verwenden Sie Advertiser Search, wenn Sie nur eine Marke oder Website kennen, Company Ads, wenn Sie eine Domain oder Werbetreibenden-ID haben, und Ad Details, wenn Sie bereits eine genaue Creative-URL besitzen.

Kann ich die Anzeigen eines Unternehmens filtern?

Ja. Optionale Steuerungen sind Thema, Region, Zeitraum, Google-Oberfläche, Format und ein begrenztes results_limit.

Können diese APIs auf private Kampagnenleistung zugreifen?

Nein. Sie arbeiten mit öffentlichen Transparenzdatensätzen und stellen keine privaten Konto- oder Kampagnenanalysen bereit.

Wie werden Ergebnisse abgerechnet?

Jeder zurückgegebene Datensatz kostet 0,5 SocQ-Credits; für ein leeres Ergebnis ist keine Grundgebühr konfiguriert.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.

Google Maps API

Finden Sie öffentliche Orte, rufen Sie normalisierte Details zu bekannten Maps-URLs ab und erfassen Sie öffentliche Bewertungen mit quellenverknüpftem Orts- und Autorenkontext.

Amazon API

Durchsuchen Sie öffentliche Amazon-Produkte und erfassen Sie normalisierte Produktdetails, Bestseller, Bewertungen, Verkäuferprofil-Datensätze und Creator-Storefronts aus unterstützten Marktplätzen.

Apple App Store API

Erfassen Sie öffentliche Apple-App-Store-App-Details, Kategorie-Rankings und Bewertungen aus bekannten Store-URLs als normalisierte App- und Bewertungsdatensätze.

SEO API

Fragen Sie live organische Google-Ergebnisse ab, vergleichen Sie Keyword-Nachfrage und Ranking-Schwierigkeit, erweitern Sie Ausgangsbegriffe, finden Sie die Keywords und Seiten, die die Sichtbarkeit einer Website in der Suche bestimmen, klassifizieren Sie die Suchintention und sammeln Sie Ergebnisse aus Google News, Google Images, Google Autocomplete, Bing und YouTube. Jeder Endpunkt nutzt denselben SocQ-API-Schlüssel, denselben asynchronen Aufgabenablauf und dasselbe normalisierte Ergebnisformat.

Telegram API

Lesen Sie öffentliche Telegram-Kanäle über ihre t.me-Links: Kanalprofile mit Abonnentenzahl, Posts mit Aufrufen und Reaktionen, einzelne Posts, Kommentare aus Diskussionsgruppen, ähnliche Kanäle und eine Suche über die gesamte Historie.

Link in Bio API

Machen Sie aus dem einen Link in der Bio auf Instagram, TikTok oder YouTube strukturierte Daten: Anzeigename, Bio, Avatar, angegebene Kontakt-E-Mail, verknüpfte Social-Profile und jeder Button der Seite mit Titel und Ziel.