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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine oder mehrere URLs von Facebook-Profilen oder -Seiten auf facebook.com, www.facebook.com oder m.facebook.com. |
results_limit | Optional | Maximale 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.
- 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.
- Senden Sie urls und optional results_limit per POST an /v1/facebook/profile-events.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- 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.
Verwandte APIs
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.