Facebook Profile Events
Gli eventi dei profili Facebook sono schede pubbliche di eventi associate a un profilo o a una pagina, con nomi, descrizioni, luoghi, orari di inizio e fine, media e metriche visibili. Il loro programma e il contesto di origine supportano l’arricchimento dei calendari degli organizzatori, la ricerca sull’inventario degli eventi e il confronto tra pagine.
Funzionalità della Facebook Profile Events API
- Feed di eventi di profili e pagineRaccogli le schede pubbliche di eventi associate a uno o più URL di profili o pagine Facebook inviati.
- Identità e programma dell’eventoRestituisce ID degli eventi, URL pubblici, nomi, descrizioni, luoghi, orari di inizio e di fine normalizzati.
- Media e metriche visibiliConserva i riferimenti normalizzati a immagini o video pubblici e le comuni metriche visibili fornite con ogni evento.
- Contesto di origine normalizzatoAssocia l’URL di origine inviato a ogni record normalizzato, rimuovendo gli eventi duplicati per ID o URL all’interno di quel feed di origine.
Parametri della Facebook Profile Events API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno o più URL di profili o pagine Facebook su facebook.com, www.facebook.com o m.facebook.com. |
results_limit | Facoltativo | Numero massimo di record di eventi da raccogliere per ogni URL di input, da 20 a 2.000; il valore predefinito è 100. |
Come usare la Facebook Profile Events API
Invia gli URL di profili o pagine come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati degli eventi con la paginazione a cursore.
- Prepara uno o più URL di profili o pagine Facebook e scegli un results_limit facoltativo da 20 a 2.000 per ogni URL.
- Invia con POST urls e un results_limit facoltativo a /v1/facebook/profile-events.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- Leggi /v1/tasks/{task_id}?limit=50 e prosegui con results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casi d’uso della Facebook Profile Events API
- Arricchimento dei calendari degli organizzatori: Usa nomi degli eventi, descrizioni, luoghi e orari di inizio e fine per arricchire calendari costruiti a partire da pagine pubbliche note di organizzatori.
- Inventario di eventi tra più pagine: Raggruppa per input_url gli ID e gli URL normalizzati degli eventi per confrontare le schede pubbliche di eventi tra profili o pagine selezionati.
- Code per la raccolta dei dettagli degli eventi: Usa gli URL degli eventi restituiti per costruire una coda deduplicata per il recupero di dettagli più approfonditi degli eventi.
- Report sui programmi pubblici: Combina campi del programma, riferimenti ai media e metriche visibili in report sugli eventi associati alle fonti pubbliche monitorate.
Consigli degli esperti per la Facebook Profile Events API
- Invia profili o pagine che espongono un feed di eventi; la sola validazione dell’host non conferma che un URL di Facebook sia una fonte adatta.
- Scegli results_limit tenendo conto del numero di URL di input, perché il limite e il costo stimato in base ai risultati si applicano separatamente a ogni URL.
- Quando lo stesso evento può essere associato a più fonti inviate, deduplica i risultati uniti per ID dell’evento o URL pubblico.
- Considera facoltativi testo della descrizione, luogo, orario di fine, media e singoli valori delle metriche quando mappi i record nella tua applicazione.
API correlate
Oltre alla Facebook Profile Events 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 Event Details API — Raccoglie metadati normalizzati, date, luoghi, media ed engagement visibile dagli URL pubblici di eventi noti.
- Facebook Profiles API — Consulta profili o Pagine pubblici da URL Facebook noti con identità, bio, avatar, contatori visibili e contesto dell’input.