facebook/
profile-events

Öffentliche Veranstaltungen zu URLs von Facebook-Profilen oder -Seiten sammeln – mit Namen, Beschreibungen, Terminen, Orten, Medien, sichtbaren Kennzahlen und Quellenkontext in normalisierten Datensätzen.

Facebook Profile Events API

Profilveranstaltungen
Mehrere URLs gleichzeitig
Öffentliche Daten
0,6 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 Profile Events

Facebook-Profilveranstaltungen sind öffentliche Veranstaltungseinträge, die einem Profil oder einer Seite zugeordnet sind, mit Namen, Beschreibungen, Orten, Start- und Endzeiten, Medien und sichtbaren Kennzahlen. Terminangaben und Quellenkontext eignen sich für die Anreicherung von Veranstalterkalendern, die Recherche zum Veranstaltungsbestand und den seitenübergreifenden Vergleich.

Funktionen der Facebook Profile Events API

  • Veranstaltungs-Feeds von Profilen und SeitenSammeln Sie öffentliche Veranstaltungseinträge, die einer oder mehreren übergebenen URLs von Facebook-Profilen oder -Seiten zugeordnet sind.
  • Identität und Termin einer VeranstaltungLiefert Veranstaltungs-IDs, öffentliche URLs, Namen, Beschreibungen, Orte sowie normalisierte Start- und Endzeiten.
  • Medien und sichtbare KennzahlenBehält normalisierte Verweise auf öffentliche Bilder oder Videos und die üblichen sichtbaren Kennzahlen bei, die zu jeder Veranstaltung gehören.
  • Normalisierter QuellenkontextHängt jedem normalisierten Datensatz die übergebene Quell-URL an und entfernt innerhalb des jeweiligen Quell-Feeds doppelte Veranstaltungen anhand von ID oder URL.

Parameter der Facebook Profile Events API

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere URLs von Facebook-Profilen oder -Seiten auf facebook.com, www.facebook.com oder m.facebook.com.
results_limitOptionalMaximale Anzahl der Veranstaltungsdatensätze, die pro Eingabe-URL gesammelt werden, von 20 bis 2.000; Standardwert ist 100.

So verwenden Sie die Facebook Profile Events API

Senden Sie URLs von Profilen oder Seiten als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Veranstaltungsdatensätze per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere URLs von Facebook-Profilen oder -Seiten vor und wählen Sie optional ein results_limit von 20 bis 2.000 pro URL.
  2. Senden Sie urls und optional results_limit per POST an /v1/facebook/profile-events.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"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 Profile Events API

  • Anreicherung von Veranstalterkalendern: Nutzen Sie Veranstaltungsnamen, Beschreibungen, Orte sowie Start- und Endzeiten, um Kalender anzureichern, die auf bekannten öffentlichen Veranstalterseiten beruhen.
  • Seitenübergreifender Veranstaltungsbestand: Gruppieren Sie normalisierte Veranstaltungs-IDs und URLs nach input_url, um öffentliche Veranstaltungseinträge über ausgewählte Profile oder Seiten hinweg zu vergleichen.
  • Warteschlangen für Veranstaltungsdetails: Bauen Sie aus den zurückgegebenen Veranstaltungs-URLs eine deduplizierte Warteschlange für den tieferen Abruf von Veranstaltungsdetails auf.
  • Berichte zu öffentlichen Terminen: Verbinden Sie Terminfelder, Medienverweise und sichtbare Kennzahlen zu Berichten über Veranstaltungen, die verfolgten öffentlichen Quellen zugeordnet sind.

Profi-Tipps zur Facebook Profile Events API

  • Übergeben Sie Profile oder Seiten, die einen Veranstaltungs-Feed bereitstellen; die Prüfung des Hosts allein bestätigt nicht, dass eine Facebook-URL eine geeignete Quelle ist.
  • Wählen Sie results_limit im Hinblick auf die Zahl der Eingabe-URLs, denn das Limit und die geschätzten ergebnisabhängigen Kosten gelten für jede URL einzeln.
  • Wenn dieselbe Veranstaltung mehreren übergebenen Quellen zugeordnet sein kann, entfernen Sie Duplikate in den zusammengeführten Ergebnissen anhand der Veranstaltungs-ID oder der öffentlichen URL.
  • Behandeln Sie Beschreibungstext, Ort, Endzeit, Medien und einzelne Kennzahlen als optional, wenn Sie die Datensätze in Ihre Anwendung übernehmen.

Ergänzend zur Facebook Profile Events 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 Profiles API — Öffentliche Profile oder Seiten aus bekannten Facebook-URLs abrufen – mit Identität, Bio, Avatar, sichtbaren Zählern und Eingabekontext.

Weitere Plattformen entdecken

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

Facebook Profile Events API — FAQ

Facebook Profile Events API ist eine Schnittstelle, die öffentliche Veranstaltungen eines angegebenen Facebook-Profils oder einer Seite sammelt, sodass Sie nicht jede Veranstaltung einzeln suchen müssen. Sie unterstützt Veranstalterkalender, Veranstaltungsbestände und Vergleiche zwischen Seiten; Ziel ist eine öffentliche Veranstaltungsquelle und keine einzelne Veranstaltungs-URL.

Übergeben Sie eine oder mehrere URLs auf facebook.com, www.facebook.com oder m.facebook.com. Die Validierung prüft den Host, nutzen Sie also Profile oder Seiten, die für einen öffentlichen Veranstaltungs-Feed geeignet sind.

results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 20 bis 2.000. Das Limit gilt für jede übergebene URL einzeln, und die Erfassung einer Quelle kann früher enden, wenn keine weiteren öffentlichen Veranstaltungen verfügbar sind.

Ein gültiger Facebook-Host garantiert nicht, dass das Ziel einen unterstützten öffentlichen Veranstaltungs-Feed bereitstellt. Auch nicht verfügbare, entfernte, alte, private oder nur nach Anmeldung zugängliche Veranstaltungen können fehlen.

Fragen Sie die zurückgegebene Aufgaben-ID ab, bis der Status succeeded lautet, und lesen Sie dann die gespeicherten Veranstaltungsdatensätze vom Endpunkt für die Aufgabenergebnisse.

Die Nutzung kostet 0,6 Credits für jeden gespeicherten Veranstaltungsdatensatz, ohne Grundgebühr pro Aufgabe. Ein leeres, abgeschlossenes Ergebnis verursacht daher keine ergebnisabhängigen Kosten.