对比 X API 的过滤流端点
| 描述 | 标准版 v1.1 | PowerTrack API | X API v2 |
|---|---|---|---|
| 访问 | X 应用 | 需要企业版合约与账户 | 需要开发者账户 (注册)、和X 应用在某个…之内项目 |
| :--- | :--- | :--- | :--- |
| 主机域 | https://stream.x.com | https://gnip-stream.x.com | https://api.x.com |
| 端点路径 | 1.1/statuses/filter.json | /stream/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter//validation.json | /2/tweets/search/stream /2/tweets/search/stream/rules |
| 认证 | OAuth 1.0a 用户上下文 | HTTP 基础认证 | OAuth 2.0 仅应用 |
| 支持的 HTTP 方法 | Post | GET Post | GET Post |
| 必填参数 | 在连接中以参数定义的规则,至少需包含以下任一项: -关注 -track(关键字跟踪) -locations | 流式连接无必需参数;可选回填参数。 规则独立管理 | 流式连接无需必填参数,可通过可选参数定义响应格式并添加其他内容断连后回补恢复功能用于学术研究权限。 规则独立管理 |
| 投放类型 | 流式 | 流式 REST(用于管理规则) | 流式 REST(用于管理规则) |
| 默认请求速率上限 | 每 5 分钟最多允许 5 次连接尝试 | 每分钟最多 60 次请求,POST 与 GET 请求合并计数 /rules:每分钟最多 60 次请求,针对特定流的 API,在 /rules 端点的所有请求(POST 和 GET)合并计数。 | 取决于端点和访问权限级别。 GET /2/tweets/search/stream: Pro - 每个应用每15分钟最多50次请求 GET /2/tweets/search/stream/rules: Pro - 每个应用每15分钟最多450次请求 *** POST /2/tweets/search/stream/rules: Pro - 每个应用每 15 分钟 100 次请求 |
| 最大允许的连接数 | 每位授权用户可同时进行 2 个并发会话 | 支持多重/冗余连接,以合同约定为准 | 免费访问: 1 |
| 恢复与冗余功能 | 无 | 回填、冗余连接与 Replay API | |
| Post 限额 | 限定为 firehose 的 1% | 以合同约定为准 | 从此端点接收的所有 Post 都受每月的 Project 级别 Post 上限限制: 基础: 10,000 条帖子 免费: 100万条 Post |
| 保活信号/心跳 | 每隔不超过 20 秒发送一次空行(\r\n 或类似) | 每隔 10 秒插入一个空行(\r\n 或类似) | 至少每 20 秒插入一次空行(\r\n 或类似) |
| 延迟 | 10秒 | 2 秒 URL 解链富化至少需要 10 秒 | 10 秒 |
| 允许的规则数量上限 | 1 条规则(在端点连接请求中) | 按合同约定,最高至 250,000 | 免费访问权限: 1000 条规则 |
| 规则过滤器限制 | 每个连接仅限一个查询,且最多为以下任一项: - 400 个跟踪关键字 - 5000 个已关注的用户 id - 25 个位置框 | 每条规则最多可包含 2,048 个字符 | 免费访问: 每条规则最多 1,024 个字符 |
| Post 的 JSON 格式 | 标准 v1.1 格式 | 原生增强版或活动流(在……中选择)控制台) | X API v2 格式(由……决定fields和expansions请求参数,与 v1.1 格式不向后兼容) 如需了解从 Standard v1.1 格式迁移到 X API v2 格式的更多信息,请访问我们的数据格式迁移指南. 我们将很快发布更多针对 Native Enriched 和 Activity Streams 的数据格式迁移指南。 |
| 提供 Post 的编辑历史与相关元数据 | ✔ | ✔ | ✔ |
| 独特功能 | 在连接请求中通过查询参数进行过滤 无配置 UI | 通过独立端点创建的规则进行过滤 数据增强合同中包含的功能 在 console.gnip.com 的 UI 中进行配置 | 通过以下方式筛选规则通过独立端点创建 指标并包含 URL 富化功能 对象fields和expansions由请求参数指定 Post(帖子)标注 会话ID运算符与字段 通过配置进行开发者门户 |