facebook-ad-library/
ad

Raccogli un annuncio pubblico della Facebook Ad Library dal suo URL, con testo creativo, contesto dell’inserzionista, media, tempistiche di diffusione e segnali visibili come record normalizzato.

Facebook Ad Library Ad API

URL di Ad Library
Contesto di creatività e inserzionista
Segnali pubblici di diffusione
0,6 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

Facebook Ad Library Ad

Gli annunci della Facebook Ad Library sono record pubblicitari pubblici con testo creativo, identità dell’inserzionista, media, call to action, tempistiche di diffusione, stato attivo e segnali disponibili di copertura o spesa. Questi campi supportano l’arricchimento di annunci selezionati, la revisione delle creatività, il monitoraggio pubblico della diffusione e il confronto in un preciso momento.

Funzionalità della Facebook Ad Library Ad API

  • Risoluzione diretta dell’URL di Ad LibraryTrasforma un URL pubblico /ads/library con un parametro di query id numerico in al massimo un record di annuncio normalizzato.
  • Contesto di creatività e inserzionistaRestituisce ID dell’archivio dell’annuncio, titolo e testo creativo, identità della pagina dell’inserzionista, URL pubblico della pagina, call to action e link di destinazione, quando esposti.
  • Diffusione e segnali visibiliConserva orari di inizio e di fine, stato attivo, piattaforme di pubblicazione, contesto dei paesi, Mi piace della pagina, copertura, valuta e spesa quando il record pubblico li fornisce.
  • Media normalizzati per annunci a più cardSeleziona il testo disponibile dello snapshot o della prima card per i campi standard e deduplica le risorse immagine e video trovate nello snapshot e nelle card, senza presentare una tabella completa delle varianti.

Parametri della Facebook Ad Library Ad API

ParametriObbligatorioDescrizione
urlObbligatorioURL pubblico obbligatorio di un annuncio della Facebook Ad Library. Usa la forma canonica https://www.facebook.com/ads/library/?id={numeric_id}; una richiesta accetta un solo URL.

Come usare la Facebook Ad Library Ad API

Invia un URL pubblico di Ad Library, segui l’attività asincrona e leggi il record dell’annuncio normalizzato dall’envelope di risultato standard.

  1. Prepara un URL pubblico della Facebook Ad Library il cui percorso è /ads/library e la cui query contiene un id numerico.
  2. Invia url a /v1/facebook-ad-library/ad e annota il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. Leggi data.results.items; questo endpoint restituisce al massimo un record, quindi next_cursor di norma resta null e has_more resta false.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one item

Casi d’uso della Facebook Ad Library Ad API

  • Arricchire un annuncio selezionato: Usa ID dell’archivio, identità dell’inserzionista, titolo creativo, testo, media, CTA, URL di destinazione e URL di input per completare un record di annuncio esistente.
  • Esaminare asset creativi e destinazioni: Controlla i riferimenti deduplicati a immagini o video insieme a formato di visualizzazione, testo della CTA, tipo di CTA e link pubblico di destinazione per un annuncio noto.
  • Esaminare il contesto pubblico di diffusione: Usa stato attivo, orari di inizio e di fine, piattaforme di pubblicazione, valori dei paesi e campi disponibili di copertura o spesa per esaminare il contesto pubblico di diffusione.
  • Conservare istantanee degli annunci in un preciso momento: Salva i campi di creatività, inserzionista, diffusione, segnali visibili, URL di input e collected_at per confrontare in seguito lo stesso annuncio noto.

Consigli degli esperti per la Facebook Ad Library Ad API

  • Invia un URL di Ad Library con il percorso esatto /ads/library e un parametro di query id numerico; URL di pagine, ID di pagine, URL di post e ID grezzi di annunci non sono input accettati.
  • Considera un’attività riuscita senza record come un esito valido di annuncio non disponibile o non trovato, quando l’URL inviato è sintatticamente valido.
  • Gestisci copertura, spesa, Mi piace della pagina, media, end_at, URL del profilo dell’inserzionista, CTA e valori dei paesi come campi pubblici facoltativi, invece di convertire i valori mancanti in zero.
  • Per gli annunci con più card o più creatività, usa il nome e il testo normalizzati come campi rappresentativi e controlla l’elenco deduplicato dei media, senza dare per scontato che sia una tabella completa per variante.

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

  • Facebook Ad Library Search API — Cerca annunci pubblici per parola chiave con controlli su corrispondenza, annuncio, paese, stato, media, ordinamento, data e numero massimo di risultati.
  • Facebook Ad Library Company Search API — Trova le Pagine inserzioniste candidate per nome di azienda o Pagina, con ID della Pagina, classificazioni, immagini, pubblico visibile e segnali di Instagram collegati.
  • Facebook Ad Library Company Ads API — Raccoglie gli annunci pubblici di una Pagina inserzionista tramite il suo ID con creatività, diffusione, mercato, media, CTA e segnali visibili.

Esplora altre piattaforme

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

Facebook Ad Library Ad API — FAQ

Facebook Ad Library Ad API recupera un annuncio pubblico da un URL di Ad Library inviato. Restituisce testo creativo, contesto dell’inserzionista, media, tempistiche di diffusione, call to action e segnali pubblici disponibili, tutti normalizzati.

Invia un URL pubblico nella forma canonica https://www.facebook.com/ads/library/?id={numeric_id}. Il percorso deve essere /ads/library e il parametro di query id deve essere numerico.

Un record può contenere ID e URL dell’archivio dell’annuncio, titolo e testo creativo, campi della pagina dell’inserzionista, media, date e stato di diffusione, piattaforme di pubblicazione, valori dei paesi, dettagli della CTA, URL di destinazione, Mi piace della pagina, copertura, valuta, spesa e contesto di raccolta.

Un URL sintatticamente valido può puntare a un annuncio pubblico non disponibile o non trovato. In quel caso l’attività può riuscire senza creare un risultato segnaposto.

Nome e testo normalizzati selezionano i valori disponibili dello snapshot o della prima card, mentre i media contengono le risorse uniche trovate nello snapshot e nelle card. Il record non è una tabella completa di ogni variante creativa.

Ogni record di annuncio restituito correttamente costa 0,6 crediti SocQ. Un’attività che non restituisce alcun risultato non comporta alcun addebito.