Zum Hauptinhalt springen
Die Endpunktgruppe der X Activity API (XAA) ermöglicht es Entwicklern, auf Aktivitätsereignisse zuzugreifen, die auf der X‑Plattform stattfinden. Entwickler können Ereignisse abonnieren, die sie interessieren, etwa ProfileBioUpdate, ProfilePictureUpdate usw., und nach der User-ID filtern, deren Ereignisse sie erhalten möchten. Die passenden Ereignisse für diese User-ID werden mit Latenz im Subsekundenbereich an Ihre App zugestellt.
Die X Activity API ist als offene Beta verfügbar. Während der offenen Beta ist mit möglichen Fehlern, grundlegenden Änderungen oder unvollständigen Funktionen zu rechnen.Ihr Feedback ist von unschätzbarem Wert — melden Sie Probleme über unsere Foren der Developer Community.

​
Übermittlungsmechanismen

Die X Activity API unterstützt derzeit die folgenden Übermittlungsmechanismen, um Ereignisse an Ihre App zu senden:

​
Unterstützte Ereignistypen

Derzeit unterstützt die X Activity API die folgenden Profilaktualisierungsereignisse:
KategorieEreignisnameBeschreibung
ProfilProfileBioUpdateAusgelöst, wenn ein Nutzer seine Profilbio aktualisiert
ProfilProfilePictureUpdateAusgelöst, wenn ein Nutzer sein Profilbild aktualisiert
ProfilProfileBannerUpdateAusgelöst, wenn ein Nutzer sein Profilbanner aktualisiert
ProfilProfileGeoUpdateAusgelöst, wenn ein Nutzer seinen Profilstandort aktualisiert
ProfilProfileUrlUpdateAusgelöst, wenn ein Nutzer die Website-URL seines Profils aktualisiert
ProfilProfileScreennameUpdateAusgelöst, wenn ein Nutzer seinen Anzeigenamen aktualisiert
ProfilProfileVerifiedBadgeUpdateAusgelöst, wenn ein Nutzer sein Verifizierungsabzeichen aktualisiert
In zukünftigen Versionen wird XAA zusätzliche Ereignistypen unterstützen, darunter soziale Interaktionen, Content‑Engagement, Monetarisierungsfunktionen und mehr. Wir werden unsere Dokumentation aktualisieren, sobald neue Ereignistypen verfügbar sind.
Hinweis: XAA liefert keine Posts. Für die Bereitstellung von Posts in Echtzeit siehe unseren Endpunkt Filtered Stream, der es Entwicklern ermöglicht, Posts in Echtzeit zu filtern und zu streamen.

​
Datenschutz von Ereignissen und Authentifizierung

Die X Activity API unterscheidet zwischen öffentlichen und privaten Ereignissen, im Einklang mit der X App, wie unten erläutert.

​
Öffentliche Ereignisse

Öffentliche Ereignisse sind Aktivitäten, die ein öffentliches Nutzerkonto öffentlich ausführt und die für alle X Nutzer sichtbar sind. Diese Ereignisse sind für alle Nutzer auf der X Plattform sichtbar und erfordern keine OAuth-Authentifizierung des Nutzers, um sie anzusehen. Aktuelle öffentliche Ereignisse:
  • Profilaktualisierungen (Bio, Bild, Banner, Standort, URL, Änderungen des Benutzernamens)
Für diese öffentlichen Ereignisse können Sie Abonnements erstellen, indem Sie die Nutzer-ID in Ihrem Filter angeben und sie über XAA empfangen.

​
Private Events

Private Events sind Aktivitäten, die eine ausdrückliche Zustimmung der Nutzerin oder des Nutzers über die OAuth-Authentifizierung erfordern. Eine Nutzerin oder ein Nutzer muss sich über X anmelden und einer Developer-App ausdrücklich die Berechtigung erteilen, auf diese Events zuzugreifen. Authentifizierungsanforderungen für Private Events:
  • Die Nutzerin oder der Nutzer muss Ihre Anwendung über OAuth 2.0 autorisieren
  • Ihre Anwendung muss die passenden OAuth‑Scopes anfordern und erhalten
  • Die Nutzerin oder der Nutzer muss Ihrer App ausdrücklich die Berechtigung erteilen, auf diese Events zuzugreifen
  • Abonnements für Private Events können nur für Nutzerinnen und Nutzer erstellt werden, die Ihre Anwendung autorisiert haben

​
Abonnementlimits

Die X Activity API hat je nach Kontostufe unterschiedliche Abonnementlimits:
PaketstufeMaximale Abonnements
KostenlosNicht verfügbar
Basic50
Pro2500
Enterprise20.000
Partner100.000
KontoeinrichtungUm auf diese Endpunkte zuzugreifen, benötigen Sie:Weitere Informationen zum Zugriff auf die Endpunkte der X API v2 finden Sie in unserem Erste-Schritte-Leitfaden.