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à | SocQ | Prodotti Google Ads |
|---|---|---|
| Uso principale | Trovare e normalizzare i record pubblici di trasparenza | Gestire account pubblicitari e campagne autorizzati |
| Input | Query, identificatore dell’azienda e filtri, oppure URL esatto della creatività | Input di account, campagna o reportistica specifici del prodotto |
| Autenticazione | Chiave API di SocQ | Credenziali e autorizzazione Google specifiche del prodotto |
| Formato della risposta | Record normalizzati di inserzionisti e annunci pubblici | Risposta 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. 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. 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. Leggi i risultati normalizzati
Elabora data.results.items; Company Ads rispetta il limite richiesto, mentre Ad Details restituisce al massimo un elemento.
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.
Combina i dati di più piattaforme per analisi di business più complete
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.


