Skip to main content

对比 X API 的过滤流端点

v2 过滤流端点组正在取代 Standard v1.1 statuses/filterPowerTrack API。如果你的代码、应用或工具使用的是旧版过滤流端点,且正考虑迁移到新版的 X API v2 端点,本对比可帮助你快速上手。 查看更深入的迁移指南: 从 Standard v1.1 迁移到 X API v2 的对比 从 PowerTrack API 迁移到 X API v2 下表对比了 X 提供的过滤流端点:  
描述标准版 v1.1PowerTrack APIX API v2
访问X 应用需要企业版合约与账户需要开发者账户 (注册)、和X 应用在某个…之内项目
:---:---:---:---
主机域https://stream.x.comhttps://gnip-stream.x.comhttps://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 方法PostGET
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 格式(由……决定fieldsexpansions请求参数,与 v1.1 格式不向后兼容)

如需了解从 Standard v1.1 格式迁移到 X API v2 格式的更多信息,请访问我们的数据格式迁移指南. 我们将很快发布更多针对 Native Enriched 和 Activity Streams 的数据格式迁移指南。
提供 Post 的编辑历史与相关元数据
独特功能在连接请求中通过查询参数进行过滤

无配置 UI
通过独立端点创建的规则进行过滤

数据增强合同中包含的功能

在 console.gnip.com 的 UI 中进行配置
通过以下方式筛选规则通过独立端点创建

指标并包含 URL 富化功能

对象fieldsexpansions由请求参数指定

Post(帖子)标注

会话ID运算符与字段

通过配置进行开发者门户
其他迁移资源 标准版 v1.1 迁移至 X API v2 PowerTrack API 迁移至 X API v2 X API 迁移中心 查看这些端点的示例代码