facebook-ad-library/
company-search

Cerca le pagine inserzioniste pubbliche della Facebook Ad Library per nome di azienda o di pagina, con ID delle pagine, categorie, immagini e segnali del pubblico di Instagram in record normalizzati.

Facebook Ad Library Company Search API

Query per azienda o pagina
Candidati tra le pagine inserzioniste
Segnali di pagina e Instagram
0,5 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 Company Search

I candidati aziendali della Facebook Ad Library sono pagine inserzioniste identificate da ID di pagina, nomi, categorie, paesi, immagini, valori di verifica e contesto Instagram collegato. Questi segnali di identità e di pubblico supportano la risoluzione degli inserzionisti, il confronto tra pagine con lo stesso nome e la selezione verificabile della pagina prima della ricerca sugli annunci.

Funzionalità della Facebook Ad Library Company Search API

  • Ricerca per azienda e nome di paginaInvia una query non vuota con il nome di un’azienda, di un brand o di una pagina e ricevi tutti i candidati tra le pagine inserzioniste restituiti da quella ricerca.
  • Identità e classificazione della paginaRestituisce ID delle pagine, nomi, URL pubblici derivati, categorie, paesi, tipi di entità, valori di verifica, immagini e stato di pagina eliminata, quando esposti.
  • Segnali visibili di pagina e InstagramMantiene i Mi piace di Facebook disponibili insieme a nomi utente Instagram collegati, numero di follower e stato di verifica nei record normalizzati dei candidati.

Parametri della Facebook Ad Library Company Search API

ParametriObbligatorioDescrizione
queryObbligatorioNome obbligatorio e non vuoto di un’azienda, di un brand o di una pagina pubblica, usato per trovare i candidati tra le pagine inserzioniste.

Come usare la Facebook Ad Library Company Search API

Invia una query con il nome di un’azienda o di una pagina, segui l’attività asincrona e controlla i candidati normalizzati tra le pagine inserzioniste.

  1. Prepara una query non vuota con il nome di un’azienda, di un brand o di una pagina pubblica.
  2. Invia con POST query a /v1/facebook-ad-library/company-search e conserva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. Leggi data.results.items e richiedi next_cursor finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

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

Casi d’uso della Facebook Ad Library Company Search API

  • Risoluzione dell’ID della pagina inserzionista: Usa ID di pagina, nomi, URL, categorie e paesi dei candidati per selezionare l’identificatore richiesto da una richiesta Company Ads limitata a una pagina.
  • Confronto tra pagine omonime e regionali: Confronta categorie, paesi, tipi di entità, immagini, valori di verifica e contesto Instagram collegato tra nomi di inserzionisti simili.
  • Selettori di inserzionisti verificabili: Salva identità della pagina, segnali visibili del pubblico, query originale e orario di raccolta dietro un selettore di inserzionisti o un indice di ricerca.

Consigli degli esperti per la Facebook Ad Library Company Search API

  • Invia solo query; results_limit e i filtri su stato, paese, media o date degli annunci non sono accettati da Company Search.
  • Quando più candidati hanno un nome simile, confronta ID della pagina, URL, categoria, paese, immagine, verifica e identità Instagram collegata, invece di scegliere il primo risultato.
  • Segui next_cursor finché has_more è false, così la paginazione dei risultati dell’attività non nasconde un candidato aziendale già salvato.
  • Tratta identità Instagram, numero di follower, valori di verifica, immagini e stato di pagina eliminata come segnali facoltativi e gestisci i campi assenti senza scartare il candidato.

Oltre alla Facebook Ad Library Company Search 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 Ads API — Raccoglie gli annunci pubblici di una Pagina inserzionista tramite il suo ID con creatività, diffusione, mercato, media, CTA e segnali visibili.
  • Facebook Ad Library Ad API — Raccoglie un annuncio pubblico della Ad Library dal suo URL con creatività, inserzionista, media, diffusione, 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 Company Search API — FAQ

Facebook Ad Library Company Search API trova candidati tra le pagine inserzioniste pubbliche da una query non vuota con il nome di un’azienda o di una pagina. Restituisce ID delle pagine, campi di identità e classificazione, immagini, metriche visibili del pubblico e contesto Instagram collegato.

L’endpoint accetta una sola stringa query obbligatoria e non vuota. Non accetta results_limit né filtri degli annunci su paese, stato, media, lingua, ordinamento o date.

No. Restituisce candidati tra le pagine inserzioniste e l’ID numerico di pagina usato da Company Ads, non creatività né record di diffusione degli annunci.

Confronta ID della pagina, nome, URL, categoria, paese, tipo di entità, immagine, valore di verifica e identità Instagram collegata. Un nome familiare da solo non basta a stabilire che un candidato sia l’inserzionista cercato.

La ricerca delle aziende non accetta results_limit e salva ogni ID di pagina unico esposto e restituito per la query. Un’attività completata può comunque paginare i record salvati con next_cursor e has_more.

Un array items vuoto significa che la ricerca non ha restituito alcun candidato tra le pagine pubbliche per quella query. Differenze di denominazione o la disponibilità della fonte pubblica possono causare un risultato vuoto, quindi non prova che l’azienda non abbia annunci.

Ogni candidato aziendale restituito costa 0,5 crediti SocQ. La stima della richiesta usa 10 candidati e, con l’attuale configurazione di fatturazione, un insieme di risultati vuoto non comporta alcun addebito.