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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array 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.
- Prepara uno o più URL pubblici di facebook.com, www.facebook.com o m.facebook.com il cui percorso contiene /events/.
- Invia urls con POST a /v1/facebook/event-details.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- 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.
API correlate
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.