facebook/
event-details

Bekannte öffentliche Facebook-Veranstaltungs-URLs in normalisierte Veranstaltungsdatensätze umwandeln – mit Metadaten, Zeitplan, Ort, Medien und sichtbaren Reaktionskennzahlen.

Facebook Event Details API

Veranstaltungsdetails
Abfrage per URL
Öffentliche Veranstaltungen
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Facebook Event Details

Facebook Event Details ist ein Endpunkt für den direkten Abruf von Veranstaltungs-URLs, die Sie bereits kennen. Senden Sie eine oder mehrere öffentliche Facebook-URLs mit /events/, um – sofern verfügbar – Veranstaltungs-ID, kanonische URL, Name, Beschreibung, Start- und Endzeit, Ort, öffentliche Medien, sichtbare Kennzahlen und Erfassungskontext zu erhalten.

Funktionen der Facebook Event Details API

  • Direkter Abruf per Veranstaltungs-URLLöst bekannte öffentliche Facebook-Veranstaltungs-URLs auf, ohne eine Suche nach Keyword, Kategorie, Stadt oder Datum auszuführen.
  • Normalisierte VeranstaltungsmetadatenLiefert eine stabile Veranstaltungsstruktur mit Feldern für Identität, kanonische URL, Name, Beschreibung und Erfassungszeitstempel.
  • Zeitplan- und OrtskontextErfasst normalisierte Start- und Endzeiten sowie den öffentlichen Ortswert, sofern die Quelle sie preisgibt.
  • Medien und sichtbare KennzahlenEnthält normalisierte öffentliche Medien sowie gängige Kennzahlen zu Interaktion oder Zusagen, sofern sie für die Veranstaltung verfügbar sind.

Parameter der Facebook Event Details API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliches Array öffentlicher Facebook-Veranstaltungs-URLs. Zulässige Hosts sind facebook.com, www.facebook.com und m.facebook.com, und jeder Pfad muss /events/ enthalten.

So verwenden Sie die Facebook Event Details API

Senden Sie Veranstaltungs-URLs als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie anschließend die normalisierten Veranstaltungsdatensätze.

  1. Bereiten Sie eine oder mehrere öffentliche URLs auf facebook.com, www.facebook.com oder m.facebook.com vor, deren Pfad /events/ enthält.
  2. Senden Sie urls per POST an /v1/facebook/event-details.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
  4. Lesen Sie data.results.items aus /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
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.

Anwendungsfälle der Facebook Event Details API

  • Anreicherung von Veranstaltungsmetadaten: Reichern Sie eine gespeicherte Veranstaltungs-URL mit normalisierter Identität, Name, Beschreibung, Ort, Zeitangaben, Medien und sichtbaren Kennzahlen an.
  • Übernahme in Kalender: Übertragen Sie verfügbare Veranstaltungsnamen, Start- und Endzeiten, Beschreibungen, Orte und Quell-URLs in eine Kalender-Pipeline.
  • Recherche zu Veranstaltern und Veranstaltungsorten: Prüfen Sie öffentliche Beschreibung, Ort, Zeitplan, Medien und Reaktionssignale für eine bestehende Liste von Veranstaltungs-URLs.
  • Aktualisierung bekannter Veranstaltungen: Führen Sie gespeicherte Veranstaltungs-URLs erneut aus, um die öffentlichen Felder zu aktualisieren, die derzeit aus der Quelle verfügbar sind.

Profi-Tipps zur Facebook Event Details API

  • Verwenden Sie die kanonische URL der Veranstaltungsdetails statt einer Veranstaltungsliste einer Seite oder einer anderen Facebook-URL, die lediglich ein Segment events enthält.
  • Behandeln Sie Name, Beschreibung, Ort, Zeitplan, Medien und Kennzahlen als optional, denn die Sichtbarkeit in der Quelle variiert je Veranstaltung.
  • Behalten Sie extra.input_url beim Abgleich der Ergebnisse mit einer Anfrage mit mehreren URLs bei; eine gesendete URL kann höchstens einen Veranstaltungsdatensatz liefern.
  • Private, gelöschte, eingeschränkte oder nur mit Anmeldung sichtbare Veranstaltungen können ohne zurückgegebenen Veranstaltungsdatensatz abgeschlossen werden.

Ergänzend zur Facebook Event Details 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 Events Search API — Öffentliche Veranstaltungen per Keyword suchen – mit Feldern zu Termin, Ort, Teilnahme, Titelmedien und Veranstaltungsstatus.
  • Facebook Profile Events API — Öffentliche Veranstaltungen zu Profil- oder Seiten-URLs erfassen, einschließlich Namen, Terminen, Orten, Medien, sichtbaren Kennzahlen und Quellkontext.

Weitere Plattformen entdecken

Kombinieren Sie Facebook-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Facebook Event Details API — FAQ

Facebook Event Details API ist eine Schnittstelle, die eine bekannte öffentliche Facebook-Veranstaltungs-URL in eine strukturierte Übersicht über Zeitplan, Ort und weitere Details umwandelt. Der Datensatz unterstützt die Anreicherung von Veranstaltungsverzeichnissen, die Kalendersynchronisierung und die Verfolgung einzelner Veranstaltungen, wobei nur öffentlich zugängliche Veranstaltungsinformationen abgedeckt sind.

Senden Sie URLs auf facebook.com, www.facebook.com oder m.facebook.com, deren Pfad /events/ enthält. Die URL einer Veranstaltungsliste einer Seite oder ein fehlerhafter Veranstaltungspfad kann die einfache Formprüfung bestehen und trotzdem keinen Datensatz liefern.

Nein. Er findet keine Veranstaltungen per Keyword, Kategorie, Stadt oder Datum. Nutzen Sie ihn, nachdem Sie bereits einzelne Veranstaltungs-URLs haben.

Die Veranstaltung kann privat, gelöscht, eingeschränkt, nur mit Anmeldung sichtbar, fehlerhaft oder für die vorgelagerte öffentliche Detailabfrage anderweitig nicht verfügbar sein.

Die Nutzung kostet 0,5 Credits pro zurückgegebenem Veranstaltungsdatensatz, ohne Grundgebühr pro Aufgabe. Ein leeres Ergebnis verursacht keine Ergebnisgebühr.