facebook/
pages

Raccogli i profili pubblici delle pagine Facebook da uno o più URL di pagine, con identità normalizzata, dati di contatto, immagini, numero di follower e di Mi piace, recensioni e valutazioni.

Facebook Pages API

Pagine
Profili
Dati pubblici
2,4 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 Pages

Le pagine Facebook sono profili pubblici di aziende, organizzazioni, creator e personaggi pubblici, con identità, categorie, descrizioni, immagini, dati di contatto e segnali sul pubblico. Questi campi di profilo e di pubblico supportano la scoperta di brand, l’arricchimento di directory, le ricerche di mercato e il confronto tra account.

Funzionalità della Facebook Pages API

  • Raccolta di pagine in batchRaccogli una o più pagine Facebook pubbliche a partire dagli URL delle pagine.
  • Identità e immagini della paginaRestituisce nome della pagina, categoria, testo delle informazioni, URL canonico, avatar e immagine di copertina come campi di profilo normalizzati.
  • Metriche visibili del pubblicoInclude le metriche visibili di follower, Mi piace della pagina, recensioni e valutazioni in un oggetto metrics coerente.
  • Dati di contatto pubbliciRestituisce i campi pubblici di sito web, email, telefono e indirizzo per l’arricchimento di contatti e directory.
  • Confine dei dati pubbliciLimita i risultati ai dati di pagine accessibili pubblicamente; i contenuti privati, riservati o visibili solo dopo l’accesso restano fuori dal confine della risposta.

Parametri della Facebook Pages API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di pagine Facebook pubbliche, separati da virgole o a capo.
results_limitFacoltativoNumero massimo di record che l’attività di raccolta deve richiedere. Deve essere un numero intero positivo.

Come usare la Facebook Pages API

Invia un’attività di raccolta, interroga il relativo ID attività finché l’elaborazione termina, poi leggi i record normalizzati delle pagine con la paginazione a cursore.

  1. Prepara uno o più URL di pagine Facebook pubbliche.
  2. Invia con POST urls e un results_limit facoltativo a /v1/facebook/pages.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. Leggi /v1/tasks/{task_id}?limit=50 e segui results.next_cursor.
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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Casi d’uso della Facebook Pages API

  • Monitoraggio delle pagine dei brand: Raccogli identità pubblica, categoria, contatti e metriche del pubblico delle pagine per tenere traccia delle pagine proprie o dei concorrenti.
  • Dataset di benchmark delle pagine: Confronta categorie, descrizioni, copertura dei contatti, numero di follower, valutazioni e altri segnali visibili del pubblico tra pagine selezionate.
  • Report e pipeline di BI: Invia i record normalizzati delle pagine pubbliche a dashboard, fogli di calcolo, data warehouse o strumenti interni di revisione.
  • Flussi di lavoro per archivi media: Salva URL delle pagine, immagini, descrizioni, campi di contatto e metriche visibili per revisioni o report successivi.
  • Social listening pubblico: Usa l’identità pubblica delle pagine e i segnali sul pubblico per arricchire cataloghi di account social e dataset di brand.

Consigli degli esperti per la Facebook Pages API

  • Verifica che ogni URL inviato corrisponda a una pagina Facebook pubblica prima di avviare un batch di grandi dimensioni.
  • Aspettati che alcune pagine pubbliche omettano campi di contatto, immagini, valutazioni o contatori del pubblico, a seconda della disponibilità dei risultati.
  • Conserva gli ID stabili delle pagine e gli URL canonici, così i processi possono essere ripetuti, verificati e deduplicati.
  • Usa Facebook Posts API quando il tuo flusso di lavoro richiede i record dei post pubblici di una pagina o di un altro URL supportato.
  • Evita di progettare flussi di lavoro basati su pagine private, post con restrizioni, superfici con accesso effettuato o dati di proprietà dell’account, a meno che documenti pubblicati a parte non li supportino in modo esplicito.

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

  • Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
  • Facebook Comments API — Raccoglie commenti pubblici, autori, engagement, media e link alla fonte a partire dagli URL dei post.
  • Facebook Profile Events API — Raccoglie gli eventi pubblici associati agli URL di profili o Pagine, con nomi, date, luoghi, media, metriche visibili e contesto della fonte.
  • Facebook Profile Photos API — Raccoglie le foto pubbliche dagli URL di profili o Pagine con didascalie, contesto dell’autore, engagement, metadati delle immagini e riferimenti alla fonte.
  • Facebook Profiles API — Consulta profili o Pagine pubblici da URL Facebook noti con identità, bio, avatar, contatori visibili e contesto dell’input.
  • Facebook Reels API — Raccoglie i Reels pubblici dagli URL di profili o Pagine con didascalie, contesto dell’autore, metadati dei video, engagement visibile e riferimenti alla fonte.

Esplora altre piattaforme

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

Facebook Pages API — FAQ

Facebook Pages API recupera i profili delle pagine accessibili pubblicamente da uno o più URL di pagine Facebook. Restituisce identità normalizzata, categorie, descrizioni, immagini, dati di contatto, numero di follower e di Mi piace, recensioni e valutazioni.

La raccolta di base delle pagine pubbliche non richiede le credenziali di un’app Facebook né un accesso a Facebook. L’API non va usata per presumere l’accesso a contenuti privati, riservati o visibili solo dopo l’accesso.

I campi comuni includono ID della pagina, nome, URL canonico, categoria, testo delle informazioni, avatar, immagine di copertina, numero di follower e di Mi piace, recensioni, valutazione, sito web, email, telefono e indirizzo.

Sì, quando i risultati pubblici della pagina espongono gli URL dell’immagine del profilo e di copertina. I client devono gestire le pagine che omettono uno o entrambi i campi immagine.

L’oggetto metrics normalizzato può includere il numero visibile di follower, di Mi piace della pagina, di recensioni e la valutazione, quando il risultato pubblico li espone.

I contenuti di Facebook sono dinamici e le strutture dei risultati pubblici possono cambiare. Campi vuoti, timeout, dati di contatto mancanti o richieste bloccate vanno gestiti come normali casi di disponibilità e di pressione sul limite di frequenza.

Usa limiti più contenuti, frequenze di richiesta prudenti, backoff dopo gli errori e timeout di elaborazione più lunghi per le pagine di grandi dimensioni. Evita raccolte ripetute ad alto volume dalla stessa pagina.