Facebook Events Search
Gli eventi di Facebook sono schede pubbliche con nomi, testo del programma, orari di inizio, luoghi, segnali di partecipazione, immagini di copertina e stato online o di evento passato. Questi record supportano la scoperta di eventi, il monitoraggio dei programmi, la ricerca sulle sedi e il confronto della partecipazione.
Funzionalità della Facebook Events Search API
- Scoperta di eventi per parola chiaveUsa una query di testo per trovare i record di eventi pubblici di Facebook legati a un argomento, un’attività, un’organizzazione o un luogo.
- Identità e programma dell’eventoRestituisce ID degli eventi, nomi, URL pubblici, testo del programma e orari di inizio normalizzati per i record corrispondenti.
- Contesto di luogo e stato dell’eventoConserva ID e nomi dei luoghi, stato online e stato di evento passato per distinguere il contesto di sede e di orario.
- Campi di partecipazione e copertinaInclude i conteggi visibili di interessati, partecipanti e persone che hanno partecipato, insieme a un riferimento pubblico all’immagine di copertina, se presente.
Parametri della Facebook Events Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Una query con parola chiave non vuota usata per cercare gli eventi pubblici di Facebook. |
results_limit | Facoltativo | Numero massimo di record di eventi da raccogliere, da 7 a 2.000; il valore predefinito è 100. |
Come usare la Facebook Events Search API
Invia una parola chiave come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati degli eventi con la paginazione a cursore.
- Prepara una query con parola chiave non vuota e scegli un results_limit facoltativo da 7 a 2.000.
- Invia con POST query e results_limit a /v1/facebook/events-search.
- 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/events-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"technology conference","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 Events Search API
- Scoperta di eventi per argomento: Usa una query mirata con nomi degli eventi, URL pubblici e testo del programma per costruire un elenco di eventi pubblici pertinenti.
- Monitoraggio dei programmi: Confronta orari di inizio normalizzati, testo del programma, ID degli eventi e stato di evento passato tra più raccolte.
- Ricerca su sedi e formati: Organizza gli eventi corrispondenti per ID del luogo, nome del luogo e stato online per studiare dove e come vengono pubblicati gli eventi.
- Confronto della partecipazione visibile: Confronta i conteggi di interessati, partecipanti e persone che hanno partecipato tra i record degli eventi, insieme a nomi e orari di inizio.
Consigli degli esperti per la Facebook Events Search API
- Usa una frase specifica su un argomento, un’attività, un’organizzazione o un luogo quando una query generica restituisce record di eventi non correlati.
- Imposta results_limit tra 7 e 2.000 in base alla copertura che ti serve; se lo ometti, vengono richiesti i 100 record predefiniti.
- Usa l’ID o l’URL pubblico di ogni evento quando unisci ricerche ripetute, così lo stesso evento non viene contato due volte.
- Considera facoltativi luogo, media di copertina, conteggi di partecipazione e campi di stato dell’evento quando mappi i record nella tua applicazione.
API correlate
Oltre alla Facebook Events Search 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 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.