facebook/
group-posts

Raccogli i post dei gruppi Facebook pubblici dagli URL dei gruppi con ordinamento selezionabile, con testo, autori, timestamp, video ed engagement visibile come record normalizzati.

Facebook Group Posts API

Post dei gruppi pubblici
Quattro modalità di ordinamento
Limite di risultati per gruppo
1,2 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 Group Posts

I post dei gruppi di Facebook sono aggiornamenti pubblici dei gruppi con testo del messaggio, identità dell’autore, orario di pubblicazione, link di origine, reazioni, commenti, visualizzazioni e video visibili. Questi record supportano il monitoraggio dell’attività dei gruppi, la ricerca sulle discussioni, il confronto dell’engagement e la reportistica sui contenuti pubblici.

Funzionalità della Facebook Group Posts API

  • Batch di URL di gruppi pubbliciAccetta uno o più URL di gruppi Facebook pubblici e conserva l’URL del gruppo di origine in ogni record di post normalizzato.
  • Quattro modalità di ordinamento dei gruppiUsa top_posts, recent_activity, chronological o chronological_listings per scegliere l’ordinamento applicato a tutti i gruppi inviati.
  • Profondità di raccolta per gruppoApplica results_limit separatamente a ogni URL di gruppo, con un valore predefinito di 100 e un intervallo accettato da 3 a 2.000.
  • Contesto di post e autoreRestituisce ID dei post, URL di origine, testo del messaggio, ID e nomi degli autori, orari di pubblicazione e orari di raccolta in una struttura coerente.
  • Engagement e video visibiliInclude i conteggi visibili di reazioni, commenti e visualizzazioni dei video, oltre agli URL normalizzati di video e miniature quando un post pubblico li espone.

Parametri della Facebook Group Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioURL obbligatori di gruppi Facebook pubblici, separati da virgole o a capo.
results_limitFacoltativoNumero massimo di post richiesti per ogni URL di gruppo; il valore predefinito è 100 e accetta numeri interi da 3 a 2.000.
sort_byFacoltativoOrdinamento facoltativo applicato a ogni gruppo inviato: top_posts, recent_activity, chronological o chronological_listings.

Come usare la Facebook Group Posts API

Invia gli URL dei gruppi pubblici con ordinamento facoltativo e un limite di risultati per gruppo, poi leggi i risultati dell’attività asincrona con la paginazione a cursore.

  1. Prepara uno o più URL di gruppi Facebook pubblici.
  2. Invia con POST urls con results_limit e sort_by facoltativi a /v1/facebook/group-posts, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività ha successo o restituisce un errore.
  4. Leggi data.results.items e richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'

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

Casi d’uso della Facebook Group Posts API

  • Revisione dell’attività dei gruppi pubblici: Usa l’ordinamento recent_activity o chronological con i campi message, author, created_at e group_url per rivedere gli aggiornamenti pubblici di gruppi selezionati.
  • Archivi delle discussioni dei gruppi: Salva ID dei post, testo dei messaggi, contesto dell’autore, URL di origine, orari di pubblicazione e orari di raccolta come record pubblici dei gruppi attribuibili.
  • Confronto dell’engagement su basi uniformi: Applica lo stesso sort_by agli URL dei gruppi e confronta reactions_count, comments_count e views_count con un unico ordinamento.

Consigli degli esperti per la Facebook Group Posts API

  • Invia URL diretti di gruppi pubblici e non il nome di un gruppo, così ogni input resta legato a una fonte non ambigua.
  • Calcola la profondità richiesta come numero di urls moltiplicato per results_limit, perché il limite si applica separatamente a ogni gruppo.
  • Esegui attività separate quando confronti le modalità di ordinamento, perché un solo valore di sort_by viene applicato a ogni URL di gruppo di una richiesta.
  • Conserva insieme id ed extra.group_url, così i record a valle restano attribuibili e possono essere deduplicati all’interno di ogni gruppo.
  • Considera facoltativi autore, messaggio, orario di pubblicazione, video e conteggi delle visualizzazioni dei video quando un post pubblico non li espone.
  • Segui results.next_cursor finché has_more è false quando l’attività completata contiene più di una pagina di risultati.

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

  • Facebook Pages API — Recupera i profili pubblici delle Pagine, i dati di contatto, le immagini e le valutazioni visibili del pubblico.
  • 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 Video Transcript API — Estrae, quando disponibili, il testo e il formato della trascrizione dagli URL pubblici di video o Reels noti.
  • Facebook Ad Transcript API — Estrae, quando disponibili, il testo parlato, la lingua, il formato e il contesto della fonte dagli URL della Facebook Ad Library.
  • 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.

Esplora altre piattaforme

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

Facebook Group Posts API — FAQ

Facebook Group Posts API è un’interfaccia programmatica per recuperare i post pubblici da uno o più URL di gruppi Facebook, con ordinamento facoltativo. Restituisce testo dei post, dati dell’autore, timestamp, video, engagement visibile e URL del gruppo di origine, tutto normalizzato.

Invia uno o più URL di gruppi Facebook pubblici in urls. Gli elenchi di input vuoti vengono rifiutati e i contenuti che la superficie pubblica del gruppo non espone non possono comparire nei risultati.

sort_by accetta top_posts, recent_activity, chronological o chronological_listings. Il valore selezionato si applica a ogni URL di gruppo della richiesta.

results_limit ha come valore predefinito 100, accetta numeri interi da 3 a 2.000 e si applica separatamente a ogni URL di gruppo. Due URL con results_limit 30 richiedono fino a 60 post.

Un record normalizzato può includere id, url, message, author, reactions_count, comments_count, views_count, video, created_at, collected_at ed extra.group_url. I campi assenti nel post pubblico restano null, zero o vuoti in base al loro tipo normalizzato.

Leggi data.results.items da GET /v1/tasks/{task_id}. Quando has_more è true, passa results.next_cursor come cursor nella richiesta successiva dell’attività; ogni pagina accetta un limit da 1 a 500.

Ogni record di post di gruppo restituito costa 1,2 crediti SocQ. La stima della richiesta usa urls moltiplicato per results_limit, e un insieme di risultati vuoto non ha alcun addebito.