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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di pagine Facebook pubbliche, separati da virgole o a capo. |
results_limit | Facoltativo | Numero 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.
- Prepara uno o più URL di pagine Facebook pubbliche.
- Invia con POST urls e un results_limit facoltativo a /v1/facebook/pages.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- 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.
API correlate
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.