X API のフィルタードストリームエンドポイントの比較
| 概要 | 標準 v1.1 | PowerTrack API(パワートラック 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 |
| 必須パラメータ | 接続のパラメーターとして定義されるルール。次のうち少なくとも1つ: -フォロー -トラック -ロケーション | ストリーミング接続に必須パラメータはありません。任意の backfill パラメータがあります。 ルールは別管理 | ストリーミング接続に必須パラメータはありません。応答形式の指定や、Academic Research アクセス向けのバックフィル復旧機能の追加にはオプションパラメータを使用できます。バックフィル回復機能Academic Research アクセス用。 ルールは別管理 |
| 配信の種類 | ストリーミング | ストリーミング REST(ルール管理) | ストリーミング REST(ルール管理) |
| 既定のリクエストレート制限 | 5分あたり接続試行は5回まで | POST および GET リクエストの合計で、1 分あたり 60 リクエスト /rules: 1分あたり60リクエスト(特定のストリームのAPIに対する /rules エンドポイントへのすべてのリクエストを合算。POSTおよびGETを含む)。 | エンドポイントとそのアクセス レベル. GET /2/tweets/search/stream: プロ - アプリごとに15分あたり50件のリクエスト GET /2/tweets/search/stream/rules: プロ - アプリごとに15分あたり450リクエスト *** POST /2/tweets/search/stream/rules: プロ - アプリごとに15分あたり100リクエスト |
| 最大許可接続数 | 認可ユーザーごとの同時実行数: 2 | 契約により、複数・冗長接続をサポート | プロアクセス: 1 |
| 復旧と冗長化の機能 | なし | バックフィル、冗長接続、リプレイ API | |
| Postの上限 | Firehoseの1%に制限 | 契約で定める | このエンドポイントから受信するすべてのPostには、Project単位の月間Post上限が適用されます。 ベーシック: 10,000件のPost プロ: 100万件のPost |
| キープアライブ信号/ハートビート | 空行(\r\n など)を少なくとも 20 秒ごとに挿入 | 10秒ごとに空行(\r\n など)を出力 | 空行(\r\n など)を少なくとも20秒ごとに送信する |
| レイテンシー | 10秒 | 2秒 URLアンワインドのエンリッチメントには最低10秒 | 10秒 |
| 最大許可ルール数 | 1件のルール(エンドポイント接続リクエスト内) | 契約により最大250,000まで | プロ アクセス: 1000件のルール |
| ルールフィルターの制約 | 接続ごとに1件のクエリ、上限は次のいずれか: - 追跡キーワード 400件 - ユーザーのフォロー先idを5,000件 - ロケーションボックス 25 個 | 各ルールにつき最大 2,048 文字 | プロアクセス: 各ルール 1,024 文字 |
| Post のJSON形式 | 標準 v1.1 形式 | ネイティブ拡張またはアクティビティストリーム(コンソール内で選択)コンソール) | X API v2 の形式(によって決定fieldsおよびexpansionsrequest parameters(v1.1 の形式との後方互換性はありません) Standard v1.1 フォーマットから X API v2 フォーマットへの移行について詳しくは、こちらのデータフォーマット移行ガイド. まもなく、Native Enriched と Activity Streams 向けの追加のデータフォーマット移行ガイドを公開します。 |
| Post の編集履歴とメタデータを提供します | ✔ | ✔ | ✔ |
| 独自の機能 | 接続リクエスト時のクエリパラメータを用いたフィルタリング 設定UIはありません | 独立したエンドポイントで作成したルールによるフィルタリング エンリッチメント契約で利用できる機能 console.gnip.com のUIでの設定 | フィルタリング方法ルール独立したエンドポイント経由で作成 メトリクスおよび URL 拡充機能を含む オブジェクトfieldsおよびexpansionsリクエストパラメータで指定 ポスト注釈 会話 ID演算子とフィールド 〜による構成開発者ポータル |