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à.

facebook/pages
Profili2,4 crediti per risultato

facebook/posts
Post1 credito per risultato

facebook/group-posts
Post1,2 crediti per risultato

facebook/reels
Post0,7 crediti per risultato

facebook/comments
Commenti0,3 crediti per risultato

facebook/comment-replies
Commenti0,3 crediti per risultato

facebook/company-reviews
Commenti0,5 crediti per risultato

facebook/video-transcript
Post0,7 crediti per risultato

facebook/ad-transcript
Post0,5 crediti per risultato

facebook/events-search
Ricerca0,6 crediti per risultato

facebook/event-details
Ricerca0,5 crediti per risultato

facebook/profile-events
Profili0,6 crediti per risultato

facebook/profile-photos
Post0,5 crediti per risultato

facebook/profiles
Profili1,2 crediti per risultato
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à | SocQ | Facebook Graph API |
|---|---|---|
| Uso principale | Raccolta di dati pubblici di pagine, post, post di gruppi, commenti, eventi e trascrizioni | Gestire pagine, app e risorse autorizzate |
| OAuth del cliente | Chiave API di SocQ; nessun OAuth Facebook del cliente | Revisione dell’app Meta, permessi e token di accesso |
| Creare o modificare post | Non supportato | Supportato con i permessi idonei della pagina |
| Dati privati o riservati | Non supportato | Solo i dati concessi tramite permessi autorizzati |
| Formato della risposta | Record SocQ normalizzati | Oggetti 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. 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. 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. Leggi e pagina
Recupera gli elementi normalizzati dei risultati e segui next_cursor quando l’attività contiene altri record.
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=50Casi 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.
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.