X API のフィルタ済みストリームエンドポイントの比較
| 概要 | Standard v1.1 | PowerTrack API | X API v2 |
|---|---|---|---|
| アクセス | X App | エンタープライズ契約およびアカウントが必要 | 開発者アカウント (登録) と、Project 内の X App が必要です |
| :--- | :--- | :--- | :--- |
| ホストドメイン | 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 Basic 認証 | OAuth 2.0 App-Only |
| サポート対象の HTTP メソッド | POST | GET POST | GET POST |
| 必須パラメータ | ルールは接続時のパラメーターとして指定し、次のうち少なくとも 1 つを含める必要があります: * follow * track * locations | ストリーミング接続に必須パラメータはなく、任意で backfill パラメータを指定できます。 ルールは別途管理されます。 | ストリーミング接続に必須パラメータはなく、レスポンス形式を指定したり、Academic Research アクセス向けの バックフィル復旧機能 を追加したりするための任意パラメータがあります。 ルールは別途管理されます。 |
| 配信タイプ | ストリーミング | ストリーミング REST (ルール管理) | ストリーミング REST (ルール管理用) |
| デフォルトリクエストに対するレート制限 | 5分あたり最大5回の接続試行 | POST および GET リクエストを合わせて、1 分あたり 60 件のリクエスト /rules: 特定のストリームの API の /rules エンドポイントへのすべてのリクエスト (POST および GET) を合わせて、1 分あたり 60 件のリクエスト。 | エンドポイントごとに異なります。最新の上限値については レート制限 を参照してください。 |
| 許可される最大接続数 | 認可ユーザー1人あたり同時接続2件 | 契約に基づき、複数/冗長構成での接続をサポート | 従量課金: 1 |
| 復旧および冗長化機能 | なし | バックフィル、冗長接続、および Replay API | |
| キープアライブ信号/ハートビート | 少なくとも20秒ごとに空行 (\r\n など) | 10秒ごとに空行 (\r\n など) | 少なくとも20秒ごとに空行 (\r\n など) |
| レイテンシ | 10秒 | 2 秒 URL 展開エンリッチメント処理には少なくとも 10 秒 | 10秒 |
| 許可されるルールの最大数 | エンドポイント接続リクエストあたりルール1件 | 契約により最大250,000件 | 従量課金: ルール1,000件 |
| ルールフィルターの制限 | 接続ごとに 1 件のクエリで、上限は以下のいずれか： - 追跡キーワード 400 個 - フォロー対象ユーザーID 5,000 個 - ロケーションボックス 25 個 | ルール1件あたり最大2,048文字 | 従量制：1 ルールあたり 1,024 文字 |
| ポストの JSON 形式 | Standard v1.1 形式 | Native Enriched または Activity Streams (console で選択) | X API v2 フォーマット (fields および expansions リクエストパラメータによって定義され、v1.1 フォーマットとの後方互換性はありません) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法の詳細については、データ形式移行ガイドをご覧ください。Native Enriched と Activity Streams 向けの追加のデータ形式移行ガイドも近日中に公開予定です。 |
| ポストの編集履歴とメタデータを取得可能 | ✔ | ✔ | ✔ |
| 固有の機能 | 接続リクエストのクエリパラメータでフィルタリングを実行 設定用の UI はありません | フィルタリングは独立したエンドポイントで作成されたルールによって実行されます 契約に含まれる Enrichment 機能が利用可能 console.gnip.com の UI で設定可能 | フィルタリングは、別個のエンドポイントで作成されたルールによって行われます メトリクスおよび URL エンリッチメント機能が含まれます オブジェクトのフィールドおよび expansionsをリクエストパラメータで指定できます ポストアノテーション Conversation ID オペレーターおよびフィールド 開発者コンソールから設定を行えます |