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à | SocQ | Meta Ad Library API |
|---|---|---|
| Uso principale | Cercare annunci pubblici e raccogliere dettagli di inserzionisti o annunci | Interrogare l’archivio ufficiale di trasparenza degli annunci di Meta |
| Autenticazione | Chiave API di SocQ; nessun OAuth Facebook del cliente | App Meta, token di accesso e accesso a Ad Library |
| Input iniziale | Parola chiave, nome dell’azienda, ID pagina o URL pubblico di Ad Library | Parametri di query dell’archivio ufficiale e identificatori Meta |
| Creare o gestire annunci | Non supportato | Non supportato; usa Meta Marketing API |
| Formato della risposta | Record SocQ normalizzati | Oggetti 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. 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. 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. Leggi i risultati normalizzati
Elabora data.results.items e segui next_cursor finché has_more è true.
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 trueCasi 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.
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.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.
Threads API
Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.



