Facebook Ad Library Company Ads
Gli annunci aziendali della Facebook Ad Library sono record pubblici di un inserzionista con testo creativo, media, identità della pagina, date di diffusione, stato attivo, piattaforme di pubblicazione, contesto dei paesi e segnali visibili. Questi record supportano il monitoraggio degli inserzionisti, il confronto delle creatività, la revisione per mercato e i report con l’orario di raccolta.
Funzionalità della Facebook Ad Library Company Ads API
- Raccolta limitata alla pagina dell’inserzionistaUsa l’ID numerico di una pagina inserzionista per mantenere ogni annuncio restituito associato alla pagina pubblica selezionata, e non a una ricerca per parola chiave.
- Filtri per mercato e diffusioneRestringi la raccolta per paese, stato di diffusione, tipo di media, lingua, intervallo di date e ordinamento supportato prima che i record vengano salvati.
- Campi di creatività, media e destinazioneRestituisce per ogni annuncio i titoli, i testi, le immagini o i video, i valori della CTA, gli URL pubblici di destinazione e i formati di visualizzazione disponibili.
- Contesto di inserzionista e diffusioneConserva identità della pagina, Mi piace della pagina, date di diffusione, stato attivo, piattaforme di pubblicazione, paesi, copertura, valuta e spesa quando sono esposti pubblicamente.
- Record di annunci unici e limitatiSegue le pagine di origine disponibili, rimuove gli ID dell’archivio o gli URL duplicati e si ferma a results_limit o all’ultima pagina disponibile.
Parametri della Facebook Ad Library Company Ads API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
page_id | Obbligatorio | ID numerico obbligatorio della pagina inserzionista nella Facebook Ad Library. Usa prima Company Search quando l’ID della pagina non è noto; un’attività accetta un solo ID di pagina. |
results_limit | Facoltativo | Numero massimo di annunci unici da salvare. Il valore predefinito è 100 e i valori accettati sono interi da 20 a 2.000. |
country | Facoltativo | Usa ALL oppure un codice paese di due lettere. Il valore predefinito è ALL. |
status | Facoltativo | Filtro sullo stato di diffusione dell’annuncio. Usa esattamente ALL, ACTIVE o INACTIVE; il valore predefinito è ACTIVE. |
media_type | Facoltativo | Filtro sul tipo di media della creatività. Usa esattamente ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME o NONE; il valore predefinito è ALL. |
language | Facoltativo | Codice di due lettere facoltativo per la lingua dell’annuncio. |
sort_by | Facoltativo | Ordina gli annunci restituiti per total_impressions o relevancy_monthly_grouped; il valore predefinito è total_impressions. |
start_date | Facoltativo | Data di inizio facoltativa nel formato YYYY-MM-DD. Non può essere successiva a end_date. |
end_date | Facoltativo | Data di fine facoltativa nel formato YYYY-MM-DD. Non può essere precedente a start_date. |
Come usare la Facebook Ad Library Company Ads API
Invia l’ID di una pagina inserzionista con filtri facoltativi, segui l’attività asincrona e leggi i record degli annunci normalizzati con la paginazione a cursore.
- Ricava l’ID numerico della pagina inserzionista e scegli eventuali filtri per paese, stato, media, lingua, ordinamento o date.
- Invia page_id e i filtri selezionati a /v1/facebook-ad-library/company-ads, poi annota il task_id.
- Interroga /v1/tasks/{task_id} finché l’elaborazione riesce o restituisce un errore.
- Leggi data.results.items, poi richiedi la pagina successiva con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Facebook Ad Library Company Ads API
- Monitoraggio degli annunci di un inserzionista: Tieni traccia di ID dell’archivio, testo creativo, media, stato attivo, date di diffusione, URL di origine e collected_at per la pagina di un inserzionista noto.
- Confronto di creatività e formati: Confronta testo, immagini o video, formato di visualizzazione, CTA, link di destinazione e contesto di collazione tra gli annunci restituiti della pagina.
- Revisione degli annunci filtrata per mercato: Applica filtri per paese, lingua, stato, media e date per costruire insiemi di annunci separati per domande specifiche su mercato o diffusione.
- Report sulle istantanee dei segnali pubblici: Combina identità della pagina, Mi piace della pagina, copertura, spesa, valuta, stato di diffusione e collected_at quando questi valori pubblici sono esposti.
Consigli degli esperti per la Facebook Ad Library Company Ads API
- Parti con country impostato su ALL e filtri ampi su media e date, poi restringi una condizione alla volta, così un risultato vuoto può essere interpretato correttamente.
- Usa il valore minimo di results_limit, cioè 20, mentre validi un ID di pagina e un insieme di filtri, poi aumentalo solo quando l’ambito restituito corrisponde all’attività.
- Invia attività separate per i brand con più ID di pagine inserzioniste, perché una richiesta Company Ads accetta un solo ID di pagina.
- Deduplica le esecuzioni ripetute per id dell’annuncio, tratta copertura, spesa, media e date mancanti come non disponibili e non come zero, e usa i campi di collazione per raggruppare, non per dichiarazioni sulle prestazioni.
API correlate
Oltre alla Facebook Ad Library Company Ads 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 Ad API — Raccoglie un annuncio pubblico della Ad Library dal suo URL con creatività, inserzionista, media, diffusione, CTA e segnali visibili.