facebook/
event-details

Trasforma gli URL pubblici di eventi Facebook che già conosci in record di eventi normalizzati con metadati, programma, luogo, media e metriche di risposta visibili.

Facebook Event Details API

Dettagli degli eventi
Ricerca per URL
Eventi pubblici
0,5 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 Event Details

Facebook Event Details è un endpoint di ricerca diretta per gli URL di eventi che già conosci. Invia uno o più URL pubblici di Facebook che contengono /events/ per raccogliere ID dell’evento, URL canonico, nome, descrizione, orari di inizio e fine, luogo, media pubblici, metriche visibili e contesto della raccolta, quando questi campi sono disponibili.

Funzionalità della Facebook Event Details API

  • Ricerca diretta per URL dell’eventoRisolve gli URL pubblici di eventi Facebook già noti, senza eseguire una ricerca per parola chiave, categoria, città o data.
  • Metadati normalizzati dell’eventoRestituisce una forma stabile dell’evento con identità, URL canonico, nome, descrizione e timestamp della raccolta.
  • Contesto di programma e luogoAcquisisce gli orari normalizzati di inizio e fine e il valore pubblico del luogo, quando la fonte li espone.
  • Media e metriche visibiliInclude i media pubblici normalizzati e le comuni metriche di engagement o di risposta, quando sono disponibili per l’evento.

Parametri della Facebook Event Details API

ParametriObbligatorioDescrizione
urlsObbligatorioArray obbligatorio di URL pubblici di eventi Facebook. Gli host accettati sono facebook.com, www.facebook.com e m.facebook.com, e ogni percorso deve contenere /events/.

Come usare la Facebook Event Details API

Invia gli URL degli eventi come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati degli eventi.

  1. Prepara uno o più URL pubblici di facebook.com, www.facebook.com o m.facebook.com il cui percorso contiene /events/.
  2. Invia urls con POST a /v1/facebook/event-details.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. Leggi data.results.items da /v1/tasks/{task_id}?limit=50 e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/facebook/event-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/events/123456789012345/"]}'

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

Casi d’uso della Facebook Event Details API

  • Arricchimento dei metadati degli eventi: Arricchisci l’URL di un evento già salvato con identità, nome, descrizione, luogo, orari, media e metriche visibili normalizzati.
  • Importazione nel calendario: Associa nomi, orari di inizio e fine, descrizioni, luoghi e URL di origine degli eventi disponibili a una pipeline di calendario.
  • Ricerca su organizzatori e sedi: Esamina descrizione pubblica, luogo, programma, media e segnali di risposta per un elenco esistente di URL di eventi.
  • Aggiornamento di eventi noti: Riesegui gli URL di eventi salvati per aggiornare i campi pubblici attualmente disponibili dalla fonte.

Consigli degli esperti per la Facebook Event Details API

  • Usa l’URL canonico dei dettagli dell’evento e non l’elenco degli eventi di una pagina o un altro URL di Facebook che contiene solo un segmento events.
  • Considera facoltativi nome, descrizione, luogo, programma, media e metriche, perché la visibilità della fonte varia da evento a evento.
  • Conserva extra.input_url quando riconcili i risultati con una richiesta a più URL; un URL inviato può produrre al massimo un record di evento.
  • Gli eventi privati, eliminati, con restrizioni o visibili solo dopo l’accesso possono concludersi senza restituire alcun record di evento.

Oltre alla Facebook Event Details 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 Events Search API — Cerca eventi pubblici per parola chiave con date, luogo, partecipazione, immagine di copertina e stato dell’evento.
  • Facebook Profile Events API — Raccoglie gli eventi pubblici associati agli URL di profili o Pagine, con nomi, date, luoghi, media, metriche visibili e contesto della fonte.

Esplora altre piattaforme

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

Facebook Event Details API — FAQ

Facebook Event Details API è un’interfaccia programmatica per trasformare l’URL di un evento Facebook pubblico già noto in una vista strutturata di programma, luogo e dettagli correlati. Il record risultante supporta l’arricchimento di directory di eventi, la sincronizzazione dei calendari e il monitoraggio dei singoli eventi, con una copertura limitata alle informazioni sugli eventi accessibili pubblicamente.

Invia URL di facebook.com, www.facebook.com o m.facebook.com il cui percorso contiene /events/. L’URL dell’elenco eventi di una pagina o un percorso di evento malformato può superare il controllo di forma di base e comunque non restituire alcun record.

No. Non scopre eventi per parola chiave, categoria, città o data. Usalo quando hai già gli URL dei singoli eventi.

L’evento può essere privato, eliminato, con restrizioni, visibile solo dopo l’accesso, malformato o comunque non disponibile per la ricerca pubblica dei dettagli a monte.

L’utilizzo costa 0,5 crediti per ogni record di evento restituito, senza alcun addebito base per l’attività. Un risultato vuoto non ha alcun addebito per risultato.