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