facebook/
profile-events

Raccogli gli eventi pubblici associati agli URL di profili o pagine Facebook, con nomi, descrizioni, programmi, luoghi, media, metriche visibili e contesto di origine in record normalizzati.

Facebook Profile Events API

Eventi dei profili
URL in batch
Dati pubblici
0,6 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 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

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL di profili o pagine Facebook su facebook.com, www.facebook.com o m.facebook.com.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più URL di profili o pagine Facebook e scegli un results_limit facoltativo da 20 a 2.000 per ogni URL.
  2. Invia con POST urls e un results_limit facoltativo a /v1/facebook/profile-events.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. 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.

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.

Esplora altre piattaforme

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

Facebook Profile Events API — FAQ

Facebook Profile Events API è un’interfaccia programmatica per raccogliere gli eventi pubblici associati a uno specifico profilo o a una pagina Facebook, evitando di dover individuare ogni evento separatamente. Supporta calendari degli organizzatori, inventari di eventi e confronti tra pagine; il suo target è una fonte pubblica di eventi e non l’URL di un singolo evento.

Invia uno o più URL ospitati su facebook.com, www.facebook.com o m.facebook.com. La validazione controlla l’host, quindi usa profili o pagine adatti a un feed pubblico di eventi.

results_limit ha come valore predefinito 100 e accetta numeri interi da 20 a 2.000. Il limite si applica separatamente a ogni URL inviato e la raccolta per una fonte può fermarsi prima quando non ci sono altri eventi pubblici disponibili.

Un host Facebook valido non garantisce che il target esponga un feed pubblico di eventi supportato. Possono mancare anche gli eventi non disponibili, rimossi, vecchi, privati o con accesso limitato.

Interroga l’ID attività restituito finché il suo stato è succeeded, poi leggi i record di eventi salvati dall’endpoint dei risultati dell’attività.

L’utilizzo costa 0,6 crediti per ogni record di evento salvato, senza alcun addebito base per l’attività. Un risultato completato ma vuoto non ha quindi alcun addebito basato sui risultati.