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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL pubblici di pagine, profili, gruppi o post di Facebook, 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 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.
- Prepara uno o più URL pubblici di pagine, profili, gruppi o post di Facebook.
- Invia con POST urls e un results_limit facoltativo a /v1/facebook/posts.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- 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.
API correlate
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.