API della Libreria inserzioni di Facebook: come usarla, cosa mostra e i suoi veri limiti
Questo blog spiega come funziona l'API della Libreria inserzioni di Facebook, quali dati fornisce e perché a molti esperti di marketing non basta più per analizzare le inserzioni della concorrenza.

Di
Kinnari Ashar
Tempo di lettura: 20 min

L'API di Facebook Ad Library è lo strumento ufficiale di Meta per esplorare le inserzioni pubbliche di Facebook e Instagram tramite codice anziché clic. Se hai mai provato a fare ricerca sulle inserzioni manualmente, sai già quanto velocemente diventi frustrante. Cercare una pagina alla volta, cambiare regione e monitorare le campagne attive non è un processo scalabile.
Ecco perché le persone iniziano a considerare l'API: cercano velocità, struttura e un modo per studiare concorrenti, prodotti o mercati senza passare ore all'interno dell'interfaccia della Ad Library.
Se sei un marketer che valuta le opzioni di ricerca, un dropshipper indeciso tra controlli manuali e strumenti, o un'agenzia che esplora l'automazione per la competitive intelligence pubblicitaria, questa guida fa al caso tuo. Non imparerai solo cos'è l'API. Vedrai come funziona concretamente in scenari di ricerca reali e dove non è sufficiente.
Punti chiave
L'API di Facebook Ad Library fornisce accesso automatizzato alle inserzioni pubbliche di Facebook e Instagram.
Il suo utilizzo richiede la configurazione di un account sviluppatore, l'approvazione delle autorizzazioni e la gestione regolare dei token di accesso.
L'API restituisce record grezzi di inserzioni, non analisi dettagliate, il che significa che le creatività devono essere esaminate manualmente.
I dati sul rendimento come vendite, profitto e spesa esatta non sono disponibili.
Per la maggior parte degli utenti di e-commerce, l'API è utile per l'apprendimento e l'osservazione, ma è difficile fare affidamento su di essa a lungo termine per prendere decisioni rapide.
Cos'è l'API di Facebook (Meta) Ad Library?
Meta offre una Ad Library pubblica che consente a chiunque di cercare le inserzioni attive su Facebook e Instagram. Mostra gli annunci attualmente attivi o visualizzati in passato, ed è accessibile tramite un'interfaccia web destinata all'uso manuale.
L'API di Facebook Meta Ad Library funge da controparte automatizzata di tale libreria. Non dovrai più sfogliare le inserzioni pagina per pagina, poiché consente di recuperare i dati pubblici delle inserzioni in un formato strutturato, rendendo possibile l'analisi su larga scala senza dover ricorrere a ripetitive ricerche manuali.
L'accesso viene gestito tramite la Graph API di Meta Platforms, motivo per cui l'API della Ad Library richiede permessi da sviluppatore anziché un semplice flusso di login.

Quali dati fornisce l'API di Facebook Ad Library?
L'API di Facebook Ad Library contiene le stesse informazioni pubbliche sulle inserzioni che Meta mette a disposizione per ragioni di trasparenza. Si concentra sul mostrare l'aspetto delle inserzioni, chi c'è dietro e dove vengono pubblicate.
Per quanto riguarda le creatività delle inserzioni, l'API consente di esaminare i testi e gli elementi visivi esatti utilizzati nelle campagne. Questo è il motivo per cui la maggior parte delle persone la utilizza per la ricerca di creatività.
Include:
Immagini e video utilizzati nell'inserzione
Testo principale dell'inserzione, titoli e descrizioni
Pulsanti di invito all'azione (CTA) mostrati agli utenti
Link di anteprima (snapshot) che aprono l'inserzione nel suo formato originale
Oltre alle creatività, l'API rivela anche chi ha pubblicato l'inserzione e come è stata distribuita. Ciò aiuta a contestualizzare ciascun annuncio. Mostra:
La Pagina Facebook che pubblica l'inserzione
I paesi in cui l'inserzione è apparsa
La data di inizio e la data di fine, se la pubblicazione è terminata
Se l'inserzione è attualmente attiva o inattiva
I dati su budget e copertura sono inclusi, ma solo a livello generale.
Spesa mostrata sotto forma di intervalli stimati
Intervalli di impression che indicano la copertura approssimativa
Meta Platforms mostra queste informazioni in intervalli per evitare di esporre i budget esatti o di rendere il rendimento delle campagne facilmente decodificabile tramite reverse engineering.
Cosa NON mostra l'API di Facebook Ad Library?
Tutto ciò che accade dopo che un utente ha fatto clic su un'inserzione non è incluso e le metriche di rendimento rimangono riservate all'inserzionista.
Nello specifico, l'API di Facebook Ad Library non fornisce:
Dati di conversione
Dati sulle vendite o sui ricavi
Metriche come ROAS o CPA
Dettagli sul targeting del pubblico
Qualsiasi segnale che confermi se un'inserzione è redditizia
Queste omissioni sono intenzionali. Meta Platforms limita l'accesso ai dati sulle prestazioni e sul targeting per evitare che le strategie o i risultati degli inserzionisti vengano esposti.
A chi è realmente adatta l'API di Facebook Ad Library?
L'API della Ad Library è pensata per estrarre record di inserzioni in blocco. Niente di più.
Per questo motivo, è ideale per i team che operano già su larga scala. Grandi brand e agenzie la utilizzano per monitorare l'attività pubblicitaria in vari mercati, categorie o concorrenti. L'API alimenta dashboard interne in cui tendenze, variazioni di volume o attività creative vengono monitorate nel tempo anziché valutate annuncio per annuncio.
È utile anche per i dropshipper su larga scala che gestiscono più negozi, mercati o linee di prodotti e dispongono della configurazione tecnica per elaborare dati grezzi. In questi casi, l'API supporta il monitoraggio del mercato e l'analisi creativa, non la validazione rapida.
Tuttavia, non è molto utile per la maggior parte dei consulenti o inserzionisti indipendenti. Ad esempio, se gestisci un piccolo negozio, stai testando prodotti o stai cercando di decidere se vale la pena copiare un'inserzione, l'API non è di grande aiuto. Non mostra il targeting. Non mostra le conversioni. Non dice se un'inserzione ha generato profitti.
Come accedere all'API di Facebook Ad Library?
Passaggio 1: Crea un account Meta for Developers
Inizia effettuando l'accesso a Facebook utilizzando un profilo personale reale. Gli account anonimi o condivisi non possono essere utilizzati per l'accesso per sviluppatori, nemmeno per i test di base.
Una volta effettuato l'accesso, registrati come sviluppatore tramite il portale per sviluppatori di Meta. Questo collegherà il tuo account Facebook personale ai privilegi di sviluppatore e ti consentirà di richiedere l'accesso alle API in seguito.
Per le inserzioni relative a temi sociali, elezioni o politica, è richiesta un'ulteriore verifica. Meta ti chiederà di confermare la tua identità tramite Facebook.com/ID. Questa procedura comporta l'invio di dati personali e possono essere necessari diversi giorni prima che l'approvazione sia completata.
Questo requisito è intenzionale. Meta Platforms considera la verifica dell'identità una componente fondamentale per la trasparenza e la prevenzione degli usi impropri.
Passaggio 2: Crea un'app per sviluppatori
Dopo esserti registrato come sviluppatore Meta, vai alla dashboard per sviluppatori e scegli l'opzione per creare una nuova app.
Quando richiesto, seleziona un tipo di app che supporti l'accesso per scopi di Marketing o aziendali. Completa la configurazione iniziale assegnando un nome all'app e associandola al tuo account sviluppatore.
Una volta creata, l'app diventa il tramite attraverso cui vengono effettuate tutte le richieste all'API della Ad Library. Ogni richiesta di autorizzazione, token di accesso e limite di utilizzo è associato a questa app.
Tutte le richieste all'API della Ad Library vengono effettuate tramite questa app. È un passaggio obbligatorio poiché, in assenza dell'app, non c'è modo di richiedere i dati delle inserzioni, anche se disponi già dell'accesso sviluppatore.
Passaggio 3: Richiedi l'autorizzazione per leggere le inserzioni
Con l'app configurata, è ora possibile richiedere l'autorizzazione che consente l'accesso ai dati della Ad Library. Questo permesso determina se la tua app può effettivamente visualizzare le inserzioni.
Meta potrebbe esaminare la tua richiesta o richiedere un'ulteriore verifica.
Passaggio 4: Genera un token di accesso
È necessario un token di accesso prima di poter effettuare qualsiasi richiesta all'API della Ad Library, poiché Meta lo utilizza per verificare chi invia la richiesta e se tale richiesta è autorizzata.
Puoi creare il token da Graph API Explorer selezionando la tua app per sviluppatori. Un token di accesso utente di base è sufficiente, purché l'account Facebook a esso collegato abbia completato la verifica dell'identità per l'accesso alla Ad Library.
Ogni chiamata API dipende da questo token. Quando il token scade, le richieste falliscono finché non ne generi uno nuovo. Spesso molti utenti alle prime armi si bloccano qui perché non sanno se il token è scaduto.
Con un token valido a disposizione, puoi testare l'accesso eseguendo una semplice query per la Ad Library in Graph API Explorer per verificare che i dati vengano restituiti correttamente.
Come utilizzare l'API di Facebook Ad Library?
Passaggio 1: Definisci l'obiettivo della tua ricerca
Prima di effettuare qualsiasi richiesta API, metti per iscritto una domanda chiara a cui desideri che i dati rispondano. L'API restituirà solo ciò che richiedi esplicitamente.
Inizia scegliendo un singolo ambito su cui concentrarti:
una parola chiave di prodotto su cui fare ricerca
un inserzionista specifico o una Pagina Facebook
inserzioni mostrate in un singolo paese
inserzioni attive o inserzioni già terminate
Non combinare troppi obiettivi in questa fase.
Se stai cercando un prodotto, inserisci le parole chiave che compaiono nel testo dell'inserzione. Se stai analizzando un concorrente, limita i risultati alla pagina di quell'inserzionista. Quando l'area geografica è rilevante, limita i risultati a un solo paese. Decidi in anticipo se desideri annunci attivi, annunci storici o entrambi.
Non saltare questo passaggio: se lo fai, l'API restituirà un numero elevato di inserzioni non correlate. I dati saranno formalmente corretti, ma non saranno utili per te.
Passaggio 2: Richiedi i dati delle inserzioni
Dopo aver stabilito cosa cercare, invia una richiesta a Facebook per recuperare le inserzioni.
Questa operazione viene eseguita tramite la Graph API di Facebook. Includi il tuo token di accesso e i filtri scelti in precedenza, come parole chiave, paesi, stato dell'annuncio o uno specifico inserzionista. Per i test, molti utilizzano il Graph API Explorer. Per l'uso regolare, questo passaggio avviene solitamente tramite codice.
Facebook elabora la richiesta e verifica se il token di accesso e le autorizzazioni sono validi. In caso affermativo, restituisce i risultati.
Ciò che ricevi non è una pagina web navigabile. La risposta è costituita da dati grezzi. Elenca le inserzioni e i dettagli correlati, ma non ci sono elementi visivi, riepiloghi o classifiche. Tutto ciò che desideri ordinare, confrontare o esaminare dovrà essere elaborato dopo questo passaggio.
Passaggio 3: Esamina i dati restituiti
Ogni record di inserzione include un piccolo insieme di campi di riferimento. Questi in genere includono un link di anteprima della creatività, la Pagina Facebook che pubblica l'annuncio e gli intervalli di spesa e impression. Queste informazioni aiutano a individuare quali annunci meritano attenzione, ma non mostrano la creatività vera e propria.
Per visualizzare l'annuncio reale, è necessario aprire manualmente il link di anteprima. Questo è l'unico modo per vedere immagini, video e testi nel loro formato originale.
Il lavoro a questo punto è semplice. Esamina le inserzioni restituite, seleziona quelle che corrispondono al tuo obiettivo di ricerca e apri solo le creatività rilevanti. Meta Platforms fornisce i dati, ma la revisione e l'interpretazione degli annunci richiedono comunque una valutazione manuale.
Passaggio 4: Raccogli tutti i risultati (Paginazione)
Quando i risultati di ricerca sono molto numerosi, l'API li suddivide in più blocchi. Questo meccanismo è chiamato paginazione e serve a gestire il carico del server.
Dopo aver ricevuto la prima risposta, controlla se sono disponibili altri risultati; se sì, dovrai effettuare una nuova richiesta per ottenere il gruppo successivo di inserzioni. Questo processo deve essere ripetuto fino all'esaurimento dei risultati.
Questo è un errore comune. Assicurati di continuare a inviare richieste finché l'API non smette di restituire batch aggiuntivi. Se non ottieni tutti i risultati, le conclusioni possono essere inaccurate, soprattutto se il volume complessivo è elevato.
Passaggio 5: Analizza le inserzioni manualmente
Dopo aver raccolto tutte le inserzioni, esportale o elencale in un formato facilmente consultabile, come un foglio di calcolo o una tabella. Ciò renderà possibile il confronto.
Per prima cosa, raggruppa le inserzioni per inserzionista o per prodotto. Unisci le inserzioni della stessa Pagina Facebook o raggruppa quelle che promuovono lo stesso tipo di prodotto. Questo riduce la confusione e aiuta a individuare i pattern più velocemente.
Successivamente, apri il link di anteprima di ciascuna inserzione ed esamina le creatività una ad una. Durante questa analisi, presta attenzione a tre aspetti:
creatività che si ripetono con piccole variazioni
inserzioni attive da periodi di tempo più lunghi
messaggi o angoli di comunicazione che compaiono in più inserzioni
Ora confronta le inserzioni all'interno dello stesso gruppo. Osserva come evolve il messaggio, quali formati vengono riutilizzati e se certe idee continuano a ripresentarsi. Queste ripetizioni sono più indicative di qualsiasi singolo annuncio isolato.
Questo passaggio è quello che richiede più tempo perché nulla è automatizzato. Ogni pattern deve essere individuato esaminando le inserzioni manualmente.
Casi d'uso dell'API di Facebook Ad Library per i marketer
Analisi delle inserzioni dei concorrenti
L'API di Facebook Ad Library viene spesso utilizzata per monitorare la pubblicità dei concorrenti senza dover ricorrere a ricerche manuali. Estraendo le inserzioni collegate a una specifica Pagina Facebook, puoi esaminare tutte le campagne attive e passate in un unico posto.
Ciò è utile per capire come i brand presentano le offerte, che tipo di creatività utilizzano o quali angolazioni di copywriting compaiono ripetutamente. È molto più comodo in questo modo, poiché puoi visualizzare gli annunci uno accanto all'altro, individuare le modifiche e capire con quale frequenza cambiano le creatività.
Ciò che questi dati non mostrano è il rendimento effettivo. L'API non rivela conversioni, ricavi o redditività. Per scoprirlo, dovrai svolgere analisi manuali dedicate.
Ricerca di mercato e di nicchia
Per le ricerche a livello di mercato, i marketer utilizzano l'API di Facebook Ad Library per comprendere dove si concentra l'attività pubblicitaria e quanto sia intensa. L'obiettivo non è trovare prodotti vincenti, ma capire quanto uno spazio risulti affollato o attivo.
I modi più comuni in cui l'API viene utilizzata per questo scopo includono:
Controllare quali settori presentano un elevato numero di inserzioni attive
Identificare quando più inserzionisti iniziano a promuovere prodotti simili
Confrontare il volume di pubblicità presente in un paese rispetto a un altro
Ricerche politiche e di trasparenza
Al di fuori dell'e-commerce e della ricerca di prodotto, l'API di Facebook Ad Library è ampiamente utilizzata per monitorare la pubblicità politica e basata su temi sociali. In questo ambito, l'obiettivo è la conservazione dei dati e il confronto, non l'ottimizzazione.
Monitorare le campagne politiche e vedere quali inserzioni vengono pubblicate da specifici partiti o organizzazioni
Analizzare come i messaggi cambiano nel tempo durante elezioni o eventi importanti
Confrontare come i temi sociali o politici vengono pubblicizzati in paesi diversi
L'API rende possibile studiare cosa viene comunicato e dove, ma non fornisce indicazioni sull'efficacia della copertura o sulla reazione del pubblico.
Limiti dell'API di Facebook Ad Library
Offre sì l'accesso ai dati pubblici delle inserzioni, ma presenta limiti strutturali: non è costruita per la velocità, per la scalabilità o per il monitoraggio continuo. Questi vincoli risultano evidenti non appena si iniziano a eseguire query frequenti o su larga scala.
Limiti di frequenza (Rate limits) - Le richieste hanno un tetto massimo. Se esegui query troppo spesso o estrai dataset di grandi dimensioni, i tempi di risposta rallentano o le chiamate falliscono.
Overhead delle prestazioni - Ogni richiesta passa attraverso l'autenticazione e l'elaborazione. L'esecuzione ripetuta di query comporta un ritardo significativo.
Recupero inefficiente dei dati - Alcune richieste restituiscono più dati del necessario, mentre altre richiedono più chiamate per completare un'unica visualizzazione.
Nessun aggiornamento in tempo reale - Le inserzioni non compaiono istantaneamente. È necessario continuare a verificare la presenza di nuovi dati anziché ricevere aggiornamenti automatici, operazione che richiede molto tempo.
Manutenzione continua - I token scadono, i permessi cambiano e i flussi di lavoro si interrompono senza preavviso.
WinningHunter: la migliore alternativa all'API di Facebook Ad Library
Per molti marketer, l'API di Facebook Ad Library risolve il problema dell'accesso ma introduce attriti di altra natura. La configurazione richiede tempo, i permessi necessitano di manutenzione e l'output è costituito da dati grezzi che devono ancora essere interpretati. Per i team privi di competenze o pipeline tecniche, questo approccio finisce spesso per rallentare il lavoro anziché agevolarlo.
Ecco perché molti professionisti scelgono strumenti dedicati rispetto all'uso diretto dell'API. Tali tool eliminano la necessità di configurazioni complesse e presentano i dati in un formato consultabile immediatamente, senza doversi preoccupare di token, richieste o paginazione.
WinningHunter si inserisce perfettamente in questo flusso di lavoro quando l'obiettivo è prendere decisioni anziché limitarsi a raccogliere dati. Utilizza i dati pubblici delle inserzioni senza richiedere l'accesso alle API e li organizza attraverso filtri e dashboard pronti all'uso. Anziché analizzare i record degli annunci uno per uno, puoi concentrarti subito su ciò che conta davvero.
Offre inoltre un contesto che manca nell'API della Ad Library, come il punteggio delle inserzioni, indicatori di spesa e stime sulle attività dei negozi o dei prodotti. Questo non sostituisce i test sul campo, ma aiuta a ridurre drasticamente il tempo speso a valutare manualmente annunci che hanno scarse probabilità di essere rilevanti.
FAQ
L'API di Facebook Ad Library è gratuita?
Sì, Meta non applica costi per l'utilizzo dell'API di Facebook Ad Library. Puoi accedere ai dati pubblici delle inserzioni gratuitamente. Ciò che investi, invece, è il tempo. Sono necessari un account per sviluppatori, approvazioni e la gestione continua dei token di accesso. Quando i token scadono o le autorizzazioni falliscono, devi risolvere il problema manualmente. Per molti utenti, questo carico di gestione continuo finisce per rappresentare il vero costo.
Quanto è difficile da usare per i principianti?
Per la maggior parte dei principianti, la curva di apprendimento iniziale risulta ripida. L'API non fornisce indicazioni né spiega i risultati ottenuti. Ti troverai a lavorare con risposte grezze e messaggi di errore. Spesso ci si confonde a causa di permessi mancanti, risultati incompleti o problemi con i token senza capirne il motivo. Se non hai dimestichezza con le API o con l'elaborazione di dati strutturati, il processo rischia di risultare lento e frustrante anziché formativo.
L'API di Facebook Ad Library può mostrare le inserzioni vincenti?
No. Non mostra le metriche di rendimento. Non è possibile vedere vendite, conversioni, profitti o ritorno sulla spesa pubblicitaria (ROAS). Il fatto che un'inserzione sia visibile da molto tempo non garantisce che abbia avuto successo: dimostra solo che è stata pubblicata. L'API è pensata per la trasparenza, non per il monitoraggio delle performance, e non consente di determinare quali annunci stiano effettivamente generando risultati positivi.
Quando dovrei smettere di usare l'API e passare a uno strumento dedicato?
È opportuno passare a uno strumento dedicato quando l'uso dell'API inizia a rallentare i processi decisionali. Se la maggior parte del tuo tempo viene spesa per estrarre dati, ripulirli e revisionare le inserzioni manualmente una per una, l'API cessa di essere una risorsa efficiente. Questo accade solitamente quando hai bisogno di velocità, definizione delle priorità o validazione rapida, piuttosto che del semplice accesso a record grezzi.











