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 API(パワートラック API)X 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
必須パラメータ接続のパラメーターとして定義されるルール。次のうち少なくとも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演算子とフィールド

〜による構成開発者ポータル
その他の移行リソース 標準 v1.1 から X API v2 への移行 PowerTrack API から X API v2 への移行 X API 移行ハブ これらのエンドポイントのサンプルコードを確認