facebook/
events-search

Cerca gli eventi pubblici di Facebook per parola chiave, con identità dell’evento, programma, luogo, partecipazione, immagine di copertina e campi di stato come record normalizzati.

Facebook Events Search API

Ricerca di eventi
Query con parola chiave
Eventi 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 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

ParametriObbligatorioDescrizione
queryObbligatorioUna query con parola chiave non vuota usata per cercare gli eventi pubblici di Facebook.
results_limitFacoltativoNumero 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.

  1. Prepara una query con parola chiave non vuota e scegli un results_limit facoltativo da 7 a 2.000.
  2. Invia con POST query e results_limit a /v1/facebook/events-search.
  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/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.

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.

Esplora altre piattaforme

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

Facebook Events Search API — FAQ

Facebook Events Search API è un’interfaccia programmatica per cercare gli eventi pubblici di Facebook con una query a parola chiave obbligatoria. Restituisce identità dell’evento, programma, luogo, segnali visibili di partecipazione, media di copertina e campi di stato dell’evento.

Fornisci una stringa query non vuota. results_limit è facoltativo, ha come valore predefinito 100 e accetta un numero intero da 7 a 2.000.

Un record può includere ID dell’evento, titolo, URL pubblico, testo del programma, orario di inizio, ID e nome del luogo, conteggi di interessati, partecipanti e persone che hanno partecipato, un’immagine di copertina e lo stato online o di evento passato.

La ricerca copre gli eventi pubblici che corrispondono alla parola chiave inviata. Se nessun risultato pubblico supportato corrisponde, l’attività completata restituisce un elenco items vuoto.

L’utilizzo costa 0,6 crediti per ogni record di evento restituito, senza alcun addebito base per l’attività.