Facebook Events Search
Facebook Events sind öffentliche Veranstaltungseinträge mit Namen, Zeitplantext, Startzeiten, Orten, Teilnahmesignalen, Titelbildern sowie dem Status online oder vergangen. Diese Datensätze unterstützen die Entdeckung von Veranstaltungen, die Beobachtung von Zeitplänen, die Recherche zu Veranstaltungsorten und den Vergleich der Teilnahme.
Funktionen der Facebook Events Search API
- Veranstaltungssuche per KeywordFinden Sie mit einer Textabfrage öffentliche Facebook-Veranstaltungsdatensätze zu einem Thema, einer Aktivität, einer Organisation oder einem Ort.
- Identität und Zeitplan der VeranstaltungLiefert Veranstaltungs-IDs, Namen, öffentliche URLs, Zeitplantext und normalisierte Startzeiten für passende Datensätze.
- Ort und Status der VeranstaltungBewahrt Orts-IDs, Ortsnamen, den Online-Status und den Status „vergangen“, um den Kontext von Ort und Zeitpunkt zu unterscheiden.
- Teilnahme- und TitelbildfelderEnthält die sichtbaren Zahlen für „interessiert“, „nimmt teil“ und „war dabei“ sowie einen Verweis auf das öffentliche Titelbild, sofern vorhanden.
Parameter der Facebook Events Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Eine nicht leere Keyword-Abfrage für die Suche nach öffentlichen Facebook-Veranstaltungen. |
results_limit | Optional | Maximale Anzahl der zu erfassenden Veranstaltungsdatensätze, von 7 bis 2.000; der Standardwert ist 100. |
So verwenden Sie die Facebook Events Search API
Senden Sie ein Keyword als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Veranstaltungsdatensätze per Cursor-Paginierung.
- Bereiten Sie eine nicht leere Keyword-Abfrage vor und wählen Sie optional ein results_limit von 7 bis 2.000.
- Senden Sie query und results_limit per POST an /v1/facebook/events-search.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und machen Sie mit results.next_cursor weiter, solange results.has_more den Wert true hat.
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.Anwendungsfälle der Facebook Events Search API
- Themenbezogene Veranstaltungsentdeckung: Stellen Sie mit einer fokussierten Abfrage aus Veranstaltungsnamen, öffentlichen URLs und Zeitplantext eine Liste relevanter öffentlicher Veranstaltungen zusammen.
- Beobachtung von Zeitplänen: Vergleichen Sie normalisierte Startzeiten, Zeitplantext, Veranstaltungs-IDs und den Status „vergangen“ über mehrere Erfassungsläufe.
- Recherche zu Veranstaltungsorten und -formaten: Ordnen Sie passende Veranstaltungen nach Orts-ID, Ortsname und Online-Status, um zu untersuchen, wo und wie Veranstaltungen eingestellt werden.
- Vergleich der sichtbaren Teilnahme: Vergleichen Sie die Zahlen für „interessiert“, „nimmt teil“ und „war dabei“ über Veranstaltungsdatensätze hinweg, zusammen mit Namen und Startzeiten.
Profi-Tipps zur Facebook Events Search API
- Verwenden Sie einen konkreten Ausdruck zu Thema, Aktivität, Organisation oder Ort, wenn eine breite Abfrage fachfremde Veranstaltungsdatensätze liefert.
- Legen Sie results_limit je nach gewünschter Abdeckung zwischen 7 und 2.000 fest; ohne Angabe werden die standardmäßigen 100 Datensätze angefordert.
- Nutzen Sie beim Zusammenführen wiederholter Suchen die Veranstaltungs-ID oder öffentliche URL, damit dieselbe Veranstaltung nicht doppelt gezählt wird.
- Behandeln Sie Ort, Titelmedien, Teilnahmezahlen und Statusfelder der Veranstaltung beim Abbilden der Datensätze in Ihrer Anwendung als optional.
Verwandte APIs
Ergänzend zur Facebook Events Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook-Daten benötigen.
- Facebook Pages API — Öffentliche Seitenprofile, Kontaktdaten, Bilder und sichtbare Publikumsbewertungen abrufen.
- Facebook Posts API — Öffentliche Beiträge, Medien, Reaktionen, Kommentare und Shares aus unterstützten Facebook-URLs erfassen.
- Facebook Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Medien und Quell-Links aus Beitrags-URLs erfassen.
- Facebook Video Transcript API — Verfügbaren Transkripttext und das Format aus bekannten öffentlichen Video-Beitrags- oder Reel-URLs extrahieren.
- Facebook Event Details API — Normalisierte Metadaten, Termine, Orte, Medien und sichtbare Interaktionen aus bekannten öffentlichen Veranstaltungs-URLs erfassen.
- Facebook Profile Events API — Öffentliche Veranstaltungen zu Profil- oder Seiten-URLs erfassen, einschließlich Namen, Terminen, Orten, Medien, sichtbaren Kennzahlen und Quellkontext.