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.
| Funktion | SocQ | Google-Ads-Produkte |
|---|---|---|
| Hauptzweck | Öffentliche Transparenzdatensätze finden und normalisieren | Autorisierte Werbekonten und Kampagnen verwalten |
| Eingaben | Suchbegriff, Unternehmenskennung und Filter oder genaue Creative-URL | Produktspezifische Eingaben zu Konto, Kampagne oder Reporting |
| Authentifizierung | SocQ-API-Schlüssel | Produktspezifische Google-Zugangsdaten und Autorisierung |
| Antwortformat | Normalisierte Datensätze zu öffentlichen Werbetreibenden und Anzeigen | Produktspezifische 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. 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. 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. Normalisierte Ergebnisse lesen
Verarbeiten Sie data.results.items; Company Ads beachtet die angeforderte Obergrenze, Ad Details liefert höchstens ein Element.
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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.


