facebook/
posts

Raccogli i post pubblici di Facebook da URL di pagine, profili, gruppi o post, con testo normalizzato, contesto dell’autore, media, reazioni, numero di commenti e condivisioni.

Facebook Posts API

Post
Reazioni
Dati pubblici
1 credito 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 Posts

I post di Facebook sono aggiornamenti pubblici di pagine, profili o gruppi, con testo, link, media, contesto dell’autore, timestamp ed engagement visibile. Questi segnali di contenuto e di engagement supportano il monitoraggio delle campagne, la ricerca editoriale, l’analisi del pubblico e la reportistica.

Funzionalità della Facebook Posts API

  • URL pubblici supportatiRaccogli i post da URL pubblici di pagine, profili, gruppi o post di Facebook attraverso un’unica forma di risposta normalizzata.
  • Campi di contenuto e mediaRestituisce testo dei post, ID dei post, contesto dell’autore, timestamp, link, media, condivisioni, numero di commenti e conteggi visibili delle reazioni in campi normalizzati.
  • Dettaglio delle reazioniFornisce il dettaglio visibile delle reazioni like, love, wow, care, sad, angry e haha.
  • Limite dei risultati richiestiAccetta uno o più URL supportati e usa results_limit per limitare i record di post richiesti.
  • Confine dei dati pubbliciTiene fuori dal confine della risposta i contenuti privati, riservati, visibili solo dopo l’accesso o rimossi.

Parametri della Facebook Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioURL pubblici di pagine, profili, gruppi o post di Facebook, 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 Posts API

Invia un’attività di raccolta asincrona, interroga il relativo ID attività, poi leggi i record normalizzati dei post pubblici con la paginazione a cursore.

  1. Prepara uno o più URL pubblici di pagine, profili, gruppi o post di Facebook.
  2. Invia con POST urls e un results_limit facoltativo a /v1/facebook/posts.
  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 quando esistono altri record.
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Casi d’uso della Facebook Posts API

  • Monitoraggio delle pagine pubbliche: Raccogli post pubblici, timestamp, link, riferimenti ai media e contatori visibili dalle pagine Facebook che il tuo prodotto tiene sotto controllo.
  • Report su campagne e brand: Normalizza testo dei post, reazioni, commenti, condivisioni e campi dei media prima di inviare i dati delle campagne a dashboard o strumenti di BI.
  • Ricerca sui contenuti: Analizza didascalie pubbliche, argomenti dei post, link, immagini, video e modelli di engagement intorno a un brand, un evento o un argomento.
  • Flussi di lavoro di social listening: Instrada i segnali dei post pubblici verso code di revisione, sistemi di allerta o strumenti di ricerca interni, senza mantenere parser di pagine fragili.
  • Archivio dei post e audit trail: Salva ID dei post normalizzati, URL di origine, timestamp, contatori visibili e orari di raccolta per archivi e report riproducibili.

Consigli degli esperti per la Facebook Posts API

  • Inizia con piccoli batch di pagine pubbliche, poi aumenta il limite solo quando il comportamento di nuovi tentativi e backoff funziona.
  • Salva ID dei post normalizzati, URL, ID delle attività e next_cursor, così la raccolta dei post può riprendere dopo gli errori.
  • Aspettati che alcuni post pubblici omettano commenti, media, dettagli delle reazioni o timestamp, a seconda della disponibilità della fonte.
  • Usa Comments API quando ti servono thread di commenti pubblici più approfonditi dei campi di anteprima leggeri.
  • Tieni fuori dalle ipotesi di integrazione i dati privati, riservati, visibili solo dopo l’accesso o di proprietà dell’account, a meno che la documentazione pubblicata dell’API non li supporti in modo esplicito.

Oltre alla Facebook 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 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 Group Posts API — Raccoglie i post pubblici dagli URL dei gruppi Facebook con ordinamento selezionabile, limiti per gruppo, contesto dell’autore, video ed engagement visibile.
  • 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 Profiles API — Consulta profili o Pagine pubblici da URL Facebook noti con identità, bio, avatar, contatori visibili e contesto dell’input.

Esplora altre piattaforme

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

Facebook Posts API — FAQ

Facebook Posts API raccoglie i post accessibili pubblicamente da URL di pagine, profili, gruppi o post di Facebook. Restituisce testo normalizzato, contesto dell’autore, riferimenti ai media, timestamp, reazioni, numero di commenti e condivisioni.

Invia URL pubblici di pagine, profili, gruppi aperti o post di Facebook. I gruppi privati, i profili con restrizioni, i post rimossi e le superfici visibili solo dopo l’accesso possono restituire dati limitati o nessun record.

I campi comuni del risultato includono id, url, message, author, metrics, reactions, media, created_at, collected_at ed extra. I metadati di attività e di paginazione dei risultati sono restituiti dalle risposte dell’API che li racchiudono.

La raccolta dei post pubblici non richiede cookie di Facebook forniti dal cliente. I contenuti che compaiono solo dopo l’accesso restano fuori dal confine dei dati pubblici.

Immagini, video, dettagli delle reazioni e numero visibile di commenti vengono restituiti quando il post pubblico li espone. Usa Comments API quando ti servono i singoli record dei commenti e gestisci come nullable i campi facoltativi di media o reazioni.

Usa dimensioni di pagina prudenti, backoff dopo il 429 o risposte di pressione simili ed evita cicli di nuovi tentativi troppo ravvicinati. Per i processi grandi, raccogli in batch più piccoli e riprendi dai cursori salvati.

Controlla che il target sia raggiungibile pubblicamente, che il post non sia stato rimosso o limitato e che i campi facoltativi richiesti siano esposti pubblicamente. Facebook cambia spesso la struttura delle pagine pubbliche, quindi i client devono trattare i campi mancanti come un normale caso di disponibilità.