Zum Hauptinhalt springen
Die Endpoint‑Gruppe „Filtered stream“ ermöglicht Entwicklern, einen Stream öffentlicher Posts zu filtern. Die Funktionalität dieser Endpoint‑Gruppe umfasst mehrere Endpoints, mit denen Sie Regeln erstellen und verwalten und diese Regeln anwenden können, um einen Stream von Posts zu filtern, der passende öffentliche Posts zurückgibt. Diese Endpoint‑Gruppe ermöglicht es Nutzern, bestimmte Themen und Ereignisse zu beobachten, die Unterhaltung rund um Wettbewerbe zu verfolgen, zu verstehen, wie sich Trends entwickeln, und vieles mehr. Entwickler können den REST‑rules endpoint verwenden, um Regeln zu einer persistenten Stream‑Verbindung hinzuzufügen bzw. zu entfernen, ohne die Verbindung trennen zu müssen. Diese rules können mit Operatoren erstellt werden, die auf Post‑Attribute wie Schlüsselwörter, Hashtags und URLs matchen. Operatoren und Regelklauseln lassen sich mit boolescher Logik und Klammern kombinieren, um das Matching‑Verhalten des Filters zu verfeinern. Sobald Sie eine Reihe von Regeln hinzugefügt haben, können Sie eine Streaming‑Verbindung herstellen, die Post‑Objekte im JSON‑Format über eine persistente HTTP‑Streaming‑Verbindung zu liefern beginnt. Sie erhalten nur Inhalte, die während der Verbindung zum Stream Ihren Regeln entsprechen. Alternativ können Sie den Filtered stream mit einem Webhook verknüpfen, um die Zustellung als Webhook‑Ereignisse zu erhalten. Weitere Details zur Verwendung von Webhooks mit Filtered stream finden Sie in der Einführung zu Filtered stream Webhooks. Der gefilterte Search‑Endpoint unterstützt bearbeitete Posts. Dieser Endpoint liefert bearbeitete Posts, die mit einem oder mehreren Ihrer Filter übereinstimmen, zusammen mit ihrer Bearbeitungshistorie, einschließlich eines Arrays von Post‑IDs. Für Posts ohne Bearbeitungshistorie enthält dieses Array eine einzelne ID. Für bearbeitete Posts enthält dieses Array mehrere IDs in aufsteigender Reihenfolge entsprechend der Bearbeitungsreihenfolge, wobei die aktuellste Version an letzter Position im Array steht. Um mehr darüber zu erfahren, wie Post‑Bearbeitungen funktionieren, siehe die Seite Grundlagen zu Post‑Bearbeitungen. Bestimmte Aspekte des Filtered stream Endpoints sind durch die Zugriffsstufe eingeschränkt: Pro-Zugang
  • 1000 Regeln pro Project
  • 100 Anfragen pro 15 Minuten bei Verwendung des Endpoints POST /2/tweets/search/stream/rules zum Hinzufügen von Regeln
  • Alle Operatoren können beim Erstellen Ihrer Regel verwendet werden
  • Regeln können bis zu 1024 Zeichen lang sein
Enterprise-Zugang
  • 25.000+ Regeln pro Project
  • Alle Operatoren können beim Erstellen Ihrer Regel verwendet werden
  • Regeln können bis zu 2048 Zeichen lang sein
  • Hier für Enterprise‑Zugang bewerben
Die vom Filtered stream zurückgegebenen Posts werden auf das monatliche Post cap angerechnet.
KontoeinrichtungUm auf diese Endpoints zuzugreifen, benötigen Sie:Erfahren Sie in unserem Einstiegshandbuch mehr darüber, wie Sie Zugriff auf die X API v2 Endpoints erhalten.
⌘I