Torna alle API
Dati indipendenti di trasparenza sugli annunci pubblici

Google Ad Library API

Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.

API di Google Ad Library disponibili

Usa Advertiser Search per trovare candidati, Company Ads per raccogliere insiemi limitati di creatività e Ad Details per risolvere l’URL esatto di una creatività pubblica.

Quali dati di trasparenza sugli annunci di Google puoi recuperare?

SocQ normalizza i campi pubblici disponibili del Transparency Center e mantiene null o vuoti i valori della fonte non disponibili.

Ricerca di inserzionisti

Trova per query le identità candidate degli inserzionisti, i siti web, i loghi, le regioni e i campi disponibili con il numero di annunci.

Contesto di creatività e destinazione

Raccogli testi, riferimenti agli inserzionisti, formati, risorse media e destinazioni delle landing page, quando disponibili.

Contesto di diffusione pubblico

Conserva date, paesi, superfici di Google e valori di impression normalizzati in sicurezza, quando disponibili.

SocQ e i prodotti Google Ads

SocQ normalizza i record pubblici di trasparenza supportati. I prodotti Google Ads restano la scelta giusta per le operazioni autorizzate su account e campagne.

FunzionalitàSocQProdotti Google Ads
Uso principaleTrovare e normalizzare i record pubblici di trasparenzaGestire account pubblicitari e campagne autorizzati
InputQuery, identificatore dell’azienda e filtri, oppure URL esatto della creativitàInput di account, campagna o reportistica specifici del prodotto
AutenticazioneChiave API di SocQCredenziali e autorizzazione Google specifiche del prodotto
Formato della rispostaRecord normalizzati di inserzionisti e annunci pubbliciRisposta nativa specifica del prodotto

Come funzionano le API di Google Ad Library

Tutti e tre gli endpoint usano il ciclo asincrono di SocQ per invio, interrogazione e lettura dei risultati.

  1. 1. Scegli un endpoint

    Invia una query a Advertiser Search, un dominio o un ID inserzionista a Company Ads, oppure l’URL di una creatività a Ad Details.

  2. 2. Invia e segui l’attività

    Invia la richiesta con POST, salva il task_id e interroga /v1/tasks/{task_id} finché l’elaborazione termina.

  3. 3. Leggi i risultati normalizzati

    Elabora data.results.items; Company Ads rispetta il limite richiesto, mentre Ad Details restituisce al massimo un elemento.

Raccogli gli annunci pubblici di un’azienda

Autenticati con una chiave API di SocQ e indica il dominio di un’azienda oppure l’ID di un inserzionista. Il limite predefinito di risultati è 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}

Casi d’uso comuni delle API di Google Ad Library

Ricerca di inserzionisti

Trasforma una query su un brand o su un sito web in inserzionisti pubblici candidati prima di raccogliere gli annunci.

Ricerca sulle creatività di un’azienda

Raccogli insiemi limitati di creatività pubbliche con filtri facoltativi per argomento, regione, data, superficie e formato.

Arricchimento di creatività selezionate

Completa il record di una creatività nota con i campi di inserzionista, testo, media, destinazione e diffusione.

Limiti e policy sui dati pubblici

I risultati dipendono dalla visibilità attuale della fonte pubblica e non forniscono dati privati degli account Google Ads.

  • Advertiser Search richiede una sola query e accetta una regione facoltativa; non ha un input results_limit.
  • Company Ads richiede domain o advertiser_id e accetta results_limit in multipli di 40, da 40 a 2.000.
  • Ad Details richiede un solo URL adstransparency.google.com il cui percorso contiene /creative/ e restituisce al massimo un elemento.
  • I record pubblici possono essere incompleti e non espongono budget privati, clic, conversioni, offerte, pubblici di destinazione né il ritorno sulla spesa pubblicitaria.

Domande frequenti sulle API di Google Ad Library

Quale endpoint devo usare per primo?

Usa Advertiser Search quando conosci solo un brand o un sito web, Company Ads quando hai un dominio o un ID inserzionista e Ad Details quando hai già l’URL esatto di una creatività.

Posso filtrare gli annunci di un’azienda?

Sì. I controlli facoltativi includono argomento, regione, intervallo di date, superficie di Google, formato e un results_limit limitato.

Queste API possono accedere alle prestazioni private delle campagne?

No. Lavorano con i record pubblici di trasparenza e non espongono analisi private di account o campagne.

Come vengono fatturati i risultati?

Ogni record restituito costa 0,5 crediti SocQ, senza alcun costo di base configurato per un risultato vuoto.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.

Google Maps API

Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.

Amazon API

Cerca i prodotti pubblici di Amazon e raccogli dettagli dei prodotti, Best Sellers, recensioni, profili dei venditori e vetrine dei creator normalizzati dai marketplace supportati.

Apple App Store API

Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Apple App Store da URL noti dello store, come record normalizzati di app e recensioni.

SEO API

Interroga in tempo reale i risultati organici di Google, confronta domanda delle parole chiave e difficoltà di posizionamento, espandi i termini di partenza, scopri le parole chiave e le pagine che determinano la visibilità di un sito nelle ricerche, classifica l’intento di ricerca e raccogli i risultati di Google News, Google Images, Google Autocomplete, Bing e YouTube. Ogni endpoint usa la stessa chiave API di SocQ, lo stesso flusso di attività asincrono e lo stesso formato di risultati normalizzato.

Telegram API

Leggi i canali Telegram pubblici dai loro link t.me: profili dei canali con iscritti, post con visualizzazioni e reazioni, singoli post, commenti dei gruppi di discussione, canali simili e ricerca in tutto lo storico.

Link in Bio API

Trasforma l’unico link nella bio Instagram, TikTok o YouTube di un creator in dati strutturati: nome visualizzato, bio, avatar, email di contatto indicata, profili social collegati e ogni pulsante della pagina con titolo e destinazione.