跳转到主要内容
“过滤流”端点组使开发者能够筛选公共 Post 的数据流。该端点组的功能包含多个端点，允许你创建和管理规则，并将这些规则应用于 Post 流以返回匹配的公共 Post。该端点组可用于监听特定主题与事件、监控竞赛相关的讨论、了解趋势的形成与演变等。 开发者可以使用 REST 的规则端点在不断开连接的情况下向持久流连接添加或移除规则。这些规则可以通过运算符根据 Post 的属性（如关键词、话题标签和 URL）来创建。可以将运算符与规则子句结合布尔逻辑和括号使用，以更精细地控制过滤器的匹配行为。 一旦你添加了一组规则，便可以建立流式连接，系统会通过持久的 HTTP 流式连接以 JSON 格式开始传递Post 对象。只有在连接到流时，你才会接收到与规则匹配的内容。 或者，你也可以将 Filtered Stream 关联到一个 webhook，以 webhook 事件的形式进行投递。有关在 Filtered Stream 中使用 webhooks 的更多信息，请参阅Filtered Stream Webhooks 介绍。 “过滤搜索”端点支持已编辑的 Post。该端点会传递与一个或多个过滤器匹配的已编辑 Post，以及其编辑历史，其中包含一个 Post ID 数组。对于没有编辑历史的 Post，此数组仅包含一个 ID。对于已编辑的 Post，此数组包含多个 ID，按升序排列以反映编辑顺序，数组最后一个位置为最新版本。要了解 Post 编辑的工作方式，请参阅Post 编辑基础页面。 “过滤流”端点的某些方面受访问级别限制： Pro 访问
  • 每个项目 1000 条规则
  • 当使用 POST /2/tweets/search/stream/rules 端点添加规则时，每 15 分钟 100 次请求
  • 构建规则时可使用所有运算符
  • 规则长度最多可达 1024 个字符
Enterprise 访问
  • 每个项目 25,000+ 条规则
  • 构建规则时可使用所有运算符
  • 规则长度最多可达 2048 个字符
  • 申请 Enterprise 访问请点击此处
过滤流返回的 Post 将计入每月的Post 上限。
账号设置要访问这些端点，你需要：在我们的入门指南中了解如何获取对 X API v2 端点的访问权限。