google-ad-library/
advertiser-search

Scopri i candidati inserzionisti pubblici del Google Ads Transparency Center tramite query e regione facoltativa, con identità, sito web, logo, regione e numero di annunci disponibili come campi normalizzati.

Google Ad Library Advertiser Search API

Candidati inserzionisti
Contesto regionale facoltativo
Campi di identità stabili
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Google Ad Library Advertiser Search

Il Google Ads Transparency Center può esporre più record di inserzionisti per un brand, un’organizzazione o un termine di ricerca di un sito web, comprese entità regionali o con nomi simili. Esaminare ID, nomi, siti web, loghi, regioni e numero di annunci disponibili aiuta a scegliere il record pubblico dell’inserzionista giusto prima di raccoglierne i creativi.

Funzionalità della Google Ad Library Advertiser Search API

  • Scoperta degli inserzionisti a partire dal nomeCerca con un solo termine non vuoto tra brand, organizzazione, inserzionista o sito web e ricevi candidati inserzionisti normalizzati invece dei creativi degli annunci.
  • Contesto regionale facoltativoPassa una regione come US per dare contesto alla ricerca a monte, mantenendo la regione distinta dalla geografia di pubblicazione degli annunci.
  • Campi di identità dei candidatiConfronta ID pubblico dell’inserzionista, nome, URL, sito web, logo, regione e numero di annunci indicato dalla fonte, quando disponibile, senza arricchimenti dedotti.
  • Salvataggio completo di una singola rispostaSalva tutti gli inserzionisti utilizzabili restituiti dall’unica risposta di ricerca a monte; non viene applicato alcun limite di risultati controllato da chi chiama né alcun ciclo di paginazione del provider.

Parametri della Google Ad Library Advertiser Search API

ParametriObbligatorioDescrizione
queryObbligatorioTermine di ricerca obbligatorio e non vuoto di inserzionista, brand, organizzazione o sito web. Il comportamento della corrispondenza dipende dalla fonte e non è garantito che sia esatto, per prefisso o approssimato.
regionFacoltativoStringa di regione facoltativa e non vuota, come US, inoltrata come contesto geografico della ricerca. Non dimostra dove siano stati pubblicati gli annunci di un inserzionista.

Come usare la Google Ad Library Advertiser Search API

Invia un termine di ricerca, segui l’attività asincrona e rivedi ogni candidato inserzionista normalizzato prima di usarne l’identità nelle ricerche successive.

  1. Scegli un termine specifico tra inserzionista, brand, organizzazione o sito web; se vuoi, aggiungi una regione come US.
  2. Invia con POST query e region facoltativa a /v1/google-ad-library/advertiser-search, poi salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
  4. Leggi data.results.items e verifica l’identità dei candidati con più elementi della sola somiglianza del nome, prima di scegliere l’ID di un inserzionista.
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

Casi d’uso della Google Ad Library Advertiser Search API

  • Risolvere un brand in ID di inserzionisti: Crea un elenco di candidati a partire da un nome o da un termine di sito web, prima di scegliere l’ID di un inserzionista per una richiesta separata sull’inventario pubblico degli annunci.
  • Distinguere entità regionali o giuridiche: Confronta nomi, regioni, siti web e pagine pubbliche degli inserzionisti quando più record simili possono rappresentare filiali, rivenditori o organizzazioni non correlate.
  • Creare una coda di revisione: Salva le identità dei candidati e i timestamp di raccolta per la verifica manuale, senza attribuire la proprietà in base alla sola somiglianza del nome.

Consigli degli esperti per la Google Ad Library Advertiser Search API

  • Usa una ragione sociale, un brand o un termine simile a un dominio specifici; una formulazione generica può produrre candidati ambigui e le regole di corrispondenza non sono garantite.
  • Considera la regione come contesto di ricerca e non come prova che ogni annuncio dell’inserzionista sia stato pubblicato in quella zona geografica.
  • Verifica i candidati con ID, nome, sito web, regione e la loro pagina pubblica dell’inserzionista prima di unire i record o raccogliere i creativi.
  • Non inviare results_limit: questa operazione salva l’array di inserzionisti utilizzabili restituito da una sola risposta a monte e non pagina la fonte.

Oltre alla Google Ad Library Advertiser Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Ad Library.

  • Google Ad Library Ad API — Recupera una creatività pubblica nota del Transparency Center tramite URL, con inserzionista, testo, media, diffusione, regione, formato, destinazione e impression.
  • Google Ad Library Company Ads API — Raccoglie le creatività pubbliche del Transparency Center per dominio dell’azienda o ID dell’inserzionista con controlli su argomento, regione, data, superficie, formato e numero massimo di risultati.

Esplora altre piattaforme

Combina i dati di Google Ad Library con i dati pubblici delle altre piattaforme social supportate.

Google Ad Library Advertiser Search API — FAQ

Google Ad Library Advertiser Search API è un’interfaccia programmatica per scoprire i candidati inserzionisti pubblici del Google Ads Transparency Center a partire da una query e da una regione facoltativa. Restituisce l’identità normalizzata dell’inserzionista e i campi di sito web, logo, regione e numero di annunci che dipendono dalla fonte, e non i creativi degli annunci.

Restituisce solo candidati inserzionisti. Usa l’ID o il dominio di un inserzionista verificato con la separata operazione company-ads per elencare i creativi pubblici.

La regione è un contesto geografico inoltrato alla ricerca degli inserzionisti. Può aiutare a restringere i candidati, ma non è un filtro esatto garantito né una prova della geografia di pubblicazione degli annunci.

No. È l’array completo di inserzionisti utilizzabili restituito da una sola risposta di ricerca a monte al momento della raccolta, senza un ciclo di paginazione di SocQ né un limite controllato da chi chiama.

Ogni record di inserzionista salvato costa 0,5 crediti SocQ. La stima presuppone 100 risultati e ammette uno scostamento in eccesso; un risultato vuoto riuscito comporta solo la quota base configurata a zero crediti.