Torna alle API
Dati pubblici di Facebook

Facebook Public Data API

Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.

API di Facebook disponibili

Usa Pages per i campi pubblici dei profili, Posts per i contenuti generali, Group Posts per i record a partire dall’URL di un gruppo, Comments per le discussioni, Events Search per gli eventi trovati per parola chiave e Video Transcripts per il testo parlato disponibile da URL noti di post video o di Reel. Tutte e sei usano lo stesso schema di autenticazione e di risultati delle attività.

Quali dati di Facebook puoi recuperare?

SocQ trasforma i risultati pubblici supportati di Facebook in record JSON coerenti per flussi di lavoro di arricchimento, monitoraggio, ricerca e reportistica.

Profili di pagine pubbliche

Raccogli nomi, categorie, descrizioni, URL canonici, immagini del profilo e di copertina delle pagine, quando sono pubblicamente disponibili.

Campi di contatto e pubblico

Restituisce siti web, indirizzi email, numeri di telefono, località, numero di follower, Mi piace della pagina, valutazioni e numero di recensioni pubblici, quando esposti.

Contenuti dei post pubblici

Raccogli testo dei post, autori, timestamp, link, immagini, riferimenti ai video e identificatori normalizzati dei post.

Commenti pubblici ed engagement

Raccogli testo dei commenti pubblici, campi dell’autore, timestamp, Mi piace, numero di risposte, condivisioni e segnali di reazione, quando disponibili.

Ricerca di eventi pubblici

Cerca per parola chiave nomi degli eventi, programmi, luoghi, segnali di partecipazione, immagini di copertina e stato online o di evento passato.

Trascrizioni disponibili dei video

Estrai da URL pubblici noti di post video o di Reel il testo della trascrizione collegato alla fonte, in formato testo semplice o WebVTT.

SocQ vs Facebook Graph API

SocQ si concentra sulla raccolta supportata di dati pubblici. Meta Graph API è la scelta giusta per gestire le risorse che un utente o un’azienda ha autorizzato esplicitamente.

FunzionalitàSocQFacebook Graph API
Uso principaleRaccolta di dati pubblici di pagine, post, post di gruppi, commenti, eventi e trascrizioniGestire pagine, app e risorse autorizzate
OAuth del clienteChiave API di SocQ; nessun OAuth Facebook del clienteRevisione dell’app Meta, permessi e token di accesso
Creare o modificare postNon supportatoSupportato con i permessi idonei della pagina
Dati privati o riservatiNon supportatoSolo i dati concessi tramite permessi autorizzati
Formato della rispostaRecord SocQ normalizzatiOggetti nativi di Graph API

Come funzionano le API di Facebook

La raccolta è asincrona, così la tua applicazione può inviare il lavoro, controllarne lo stato ed elaborare le pagine dei risultati in modo indipendente.

  1. 1. Invia un input

    Invia con POST URL pubblici supportati di pagine, post, gruppi, post video o Reel, oppure una query per parola chiave per la ricerca di eventi, usando i campi documentati dell’endpoint scelto.

  2. 2. Interroga l’attività

    Usa l’ID attività restituito finché l’elaborazione ha successo o fallisce. Rallenta le richieste dopo le risposte che segnalano un sovraccarico temporaneo.

  3. 3. Leggi e pagina

    Recupera gli elementi normalizzati dei risultati e segui next_cursor quando l’attività contiene altri record.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Questo esempio avvia un’attività su una pagina Facebook pubblica; usa /v1/facebook/posts per i post generali, /v1/facebook/group-posts per i post di gruppi, /v1/facebook/comments per i commenti, /v1/facebook/events-search per la ricerca di eventi o /v1/facebook/video-transcript per URL noti di post video e di Reel.

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso comuni delle API di Facebook

Monitoraggio dei brand

Segui identità pubblica della pagina, contatti, pubblico e segnali dei post per i brand di proprietà o per i concorrenti.

Ricerca su contenuti e reazioni

Analizza post pubblici, testo dei commenti, autori, timestamp, media ed engagement visibile per report o ricerche editoriali.

Arricchimento delle pagine

Aggiungi identità pubblica su Facebook, categoria, contatti e campi del pubblico a record di CRM, directory o account.

Ricerca e monitoraggio degli eventi

Usa i campi di identità, programma, luogo, partecipazione, copertina e stato degli eventi trovati per parola chiave per organizzare i record pubblici degli eventi.

Pipeline di reportistica

Invia record normalizzati di pagine e post pubblici a dashboard, data warehouse e strumenti interni di revisione.

Indicizzazione dei contenuti parlati

Indicizza il testo disponibile delle trascrizioni con il suo URL di origine e il formato per post video e Reel pubblici selezionati.

Limiti e policy sui dati pubblici

I risultati pubblici di Facebook sono dinamici. Un campo visibile per una pagina, un post, un commento, un evento o una trascrizione può mancare in un altro record o cambiare nel tempo.

  • Gruppi privati, profili riservati, post rimossi e contenuti accessibili solo con login non sono supportati.
  • I record pubblici possono omettere campi di contatto, autori dei commenti, media, contatori, timestamp, risposte o dettagli delle reazioni.
  • L’URL di un video pubblico inviato non produce alcun record di trascrizione quando il testo della trascrizione non è disponibile o è vuoto.
  • Usa lotti più piccoli, frequenze di richiesta prudenti e rallentamenti dopo blocchi temporanei o pressione sul limite di frequenza.
  • Questi endpoint non creano, aggiornano, moderano né eliminano contenuti di Facebook.

Domande frequenti sulle API di Facebook

È l’API ufficiale Facebook Graph API?

No. SocQ normalizza i risultati pubblici supportati di Facebook. Usa Meta Graph API per la gestione autorizzata delle pagine, la pubblicazione e la moderazione.

Gli utenti devono collegare gli account Facebook?

Per gli endpoint di dati pubblici supportati non serve alcun OAuth Facebook del cliente. Le richieste si autenticano con una chiave API di SocQ.

SocQ può raccogliere gruppi o profili privati?

No. I contenuti Facebook privati, riservati o accessibili solo con login non rientrano nell’ambito supportato.

Come viene calcolato il prezzo dell’utilizzo?

La scheda di ogni endpoint mostra il prezzo attuale in crediti per risultato. Le attività vengono fatturate in base ai record normalizzati che restituiscono.

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.