Torna alle API
Dati indipendenti di Facebook Ad Library

Facebook Ad Library API

Cerca gli annunci pubblici di Facebook per parola chiave, trova le pagine degli inserzionisti, raccogli gli annunci di un ID pagina o recupera un annuncio noto con campi normalizzati di creatività, media, diffusione, CTA e destinazione.

API di Facebook Ad Library disponibili

Usa Search per la ricerca di annunci per parola chiave, Company Search per trovare un ID pagina, Company Ads per raccogliere gli annunci di quella pagina o Ad Details per recuperare un annuncio pubblico noto.

Quali dati di Facebook Ad Library puoi recuperare?

SocQ restituisce record normalizzati di annunci e inserzionisti pubblici, per ricerche sulle creatività, monitoraggio dei concorrenti, analisi delle campagne e dataset pubblicitari.

Risultati di ricerca degli annunci

Cerca gli annunci pubblici per parola chiave o frase esatta, con filtri facoltativi per paese, stato, media, tipo di annuncio, data, ordinamento e limite di risultati.

Record delle pagine degli inserzionisti

Trova ID delle pagine, nomi, URL, categorie, paesi, immagini, valori di verifica, Mi piace visibili della pagina e contesto Instagram collegato.

Raccolte di annunci per pagina

Raccogli un insieme limitato di annunci pubblici univoci per un ID numerico di pagina di un inserzionista, con filtri facoltativi di diffusione e media.

Testo e media delle creatività

Recupera titoli, testi, descrizioni dei link, formati di visualizzazione e riferimenti pubblici deduplicati a immagini o video degli annunci, quando disponibili.

Contesto di diffusione e di mercato

Conserva date di inizio e di fine, stato attivo, piattaforme di pubblicazione, paesi, copertura, valuta, spesa e segnali dei Mi piace della pagina, quando disponibili.

Call to action e destinazioni

Recupera testo e tipo della CTA visibili, URL di destinazione pubblici, URL di Ad Library, identità dell’inserzionista e timestamp di raccolta, quando esposti.

SocQ vs Meta Ad Library API

SocQ offre flussi di raccolta di annunci pubblici pronti all’uso. Meta Ad Library API è la scelta ufficiale per l’accesso diretto all’archivio di trasparenza degli annunci di Meta.

FunzionalitàSocQMeta Ad Library API
Uso principaleCercare annunci pubblici e raccogliere dettagli di inserzionisti o annunciInterrogare l’archivio ufficiale di trasparenza degli annunci di Meta
AutenticazioneChiave API di SocQ; nessun OAuth Facebook del clienteApp Meta, token di accesso e accesso a Ad Library
Input inizialeParola chiave, nome dell’azienda, ID pagina o URL pubblico di Ad LibraryParametri di query dell’archivio ufficiale e identificatori Meta
Creare o gestire annunciNon supportatoNon supportato; usa Meta Marketing API
Formato della rispostaRecord SocQ normalizzatiOggetti nativi di Meta Graph API

Come funzionano le API di Facebook Ad Library

Tutte e quattro le API usano lo stesso flusso di lavoro con attività asincrona e risultati paginati.

  1. 1. Scegli l’API e l’input

    Parti da una parola chiave, un nome di azienda, un ID pagina numerico o un URL pubblico /ads/library, a seconda del record che ti serve.

  2. 2. Invia e segui l’attività

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

  3. 3. Leggi i risultati normalizzati

    Elabora data.results.items e segui next_cursor finché has_more è true.

Cerca gli annunci pubblici per parola chiave

Autenticati con la tua chiave API di SocQ e invia una parola chiave all’endpoint Search. Le altre API di Ad Library usano lo stesso flusso di attività.

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso comuni delle API di Facebook Ad Library

Monitoraggio degli annunci dei concorrenti

Segui gli annunci pubblici di pagine di inserzionisti selezionate e confronta nel tempo creatività, media, stato di diffusione, mercati, CTA e destinazioni.

Ricerca su creatività e messaggi

Cerca termini di prodotto, categoria o brand per esaminare testi degli annunci pubblici, formati, media, call to action e destinazioni delle landing page.

Ricerca di inserzionisti

Trasforma i nomi di aziende o brand in ID di pagine pubbliche e campi di identità prima di raccogliere un insieme mirato di annunci per pagina.

Dataset pubblicitari

Salva ID degli annunci normalizzati, record degli inserzionisti, campi delle creatività, contesto di diffusione, URL di origine e timestamp collected_at per l’analisi.

Limiti e policy sui dati pubblici

I risultati di Facebook Ad Library sono record pubblici rilevati in un dato momento. Queste API non gestiscono account pubblicitari né forniscono dati privati sulle prestazioni delle campagne.

  • Search richiede una sola query non vuota; results_limit ha come valore predefinito 100 e accetta interi da 20 a 2.000.
  • Company Search accetta una sola query con il nome di un’azienda o di una pagina, non accetta results_limit e può restituire più pagine candidate con nomi simili.
  • Company Ads richiede un solo ID pagina numerico; results_limit accetta da 20 a 2.000 e i filtri possono ridurre il numero di record restituiti.
  • Ad Details accetta un solo URL pubblico facebook.com/ads/library con un id numerico e restituisce al massimo un record di annuncio normalizzato.
  • Un’attività completata può non restituire alcun record quando un annuncio, una pagina o un insieme filtrato di risultati non è disponibile nella fonte pubblica.
  • Copertura, spesa, valuta, media, date, CTA, destinazione e campi dell’inserzionista possono essere assenti e non vanno interpretati come zero.

Domande frequenti sulle API di Facebook Ad Library

Che cos’è l’API di Facebook Ad Library?

L’API di Facebook Ad Library è un insieme di endpoint di SocQ per cercare annunci pubblici, trovare le pagine degli inserzionisti, raccogliere gli annunci di una pagina e recuperare i dettagli di annunci pubblici noti.

Quale API di Facebook Ad Library devo usare?

Usa Search per la ricerca per parola chiave, Company Search per trovare un ID pagina, Company Ads per raccogliere gli annunci di quell’ID e Ad Details per un URL pubblico noto di Ad Library.

Che cosa posso cercare e filtrare?

Search accetta una parola chiave o una frase esatta, più filtri facoltativi per paese, stato, media, tipo di annuncio, data, ordinamento e limite di risultati. Company Ads supporta filtri di diffusione e di media specifici per pagina.

Quali dati pubblici degli annunci vengono restituiti?

I risultati possono includere identità di annuncio e inserzionista, testi delle creatività, immagini o video, date di diffusione, stato attivo, piattaforme di pubblicazione, paesi, CTA, destinazione e segnali pubblici visibili.

Perché una richiesta completata può non restituire risultati?

La fonte pubblica può non avere corrispondenze per l’input inviato, i filtri possono escludere tutti i record oppure l’annuncio o la pagina richiesti possono non essere più disponibili pubblicamente.

È la stessa cosa dell’API dei dati social di Facebook o di Marketplace?

No. Gli endpoint di Facebook Ad Library sono separati dalle API di SocQ per pagine, post e commenti di Facebook e dalle sue API per gli annunci di Facebook Marketplace.

Come vengono fatturati i risultati di Facebook Ad Library?

Gli annunci di Search, i candidati di Company Search e i record di Company Ads costano 0,5 crediti per risultato restituito. Ad Details costa 0,6 crediti per risultato restituito e i risultati vuoti non hanno costi per risultato.

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.