> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Filtered stream 移行概要
> エンドポイント、演算子、ルール、認証要件をマッピングして、Standard v1.1 または PowerTrack から X API v2 へ Filtered stream の consumer を移行します。
## X API の Filtered stream エンドポイントを比較する
v2 の Filtered stream エンドポイント群は、[standard v1.1 statuses/filter](https://developer.x.com/en/docs/x-api/v1/tweets/filter-realtime/api-reference/post-statuses-filter) と [PowerTrack API](/x-api/enterprise-gnip-2.0/powertrack-api) を置き換えます。旧バージョンの Filtered stream エンドポイントを使用したコード、アプリ、ツールをお持ちで、より新しい X API v2 エンドポイントへの移行を検討中の場合、この比較が出発点として役立ちます。
より詳細な移行ガイドは以下をご覧ください:
[Standard v1.1 から X API v2 への移行と比較](x-api/posts/filtered-stream#standard-v1-1-compared-to-x-api-v2)
[PowerTrack API から X API v2 への移行](/x-api/enterprise-gnip-2.0/powertrack-api#powertrack-operators)
以下の表は、X が提供する Filtered streaming エンドポイントを比較しています:
| **Description** | **Standard v1.1** | **PowerTrack API** | **X API v2** |
| :-------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| アクセス | X App | Enterprise 契約とアカウントが必要 | 開発者アカウント([登録](https://developer.x.com/en/portal/petition/essential/basic-info))、および [Project](/resources/fundamentals/developer-apps) 内の [X App](/resources/fundamentals/developer-apps) が必要 |
| :--- | :--- | :--- | :--- |
| Host domain | **[https://stream.x.com](https://stream.x.com)** | **[https://gnip-stream.x.com](https://gnip-stream.x.com)** | **[https://api.x.com](https://api.x.com)** |
| Endpoint path | **1.1/statuses/filter.json** | **/stream/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}.json**
**/rules/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}.json **
**/rules/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}/validation.json** | **/2/tweets/search/stream**
**/2/tweets/search/stream/rules** |
| [認証](/resources/fundamentals/authentication) | OAuth 1.0a User Context | HTTP Basic Authentication | OAuth 2.0 App-Only |
| サポートする HTTP メソッド | POST | GET
POST | GET
POST |
| 必須パラメーター | 接続時にパラメーターとしてルールを定義。以下のうち少なくとも 1 つ:
\* **follow**
\* **track**
\* **locations** | ストリーミング接続に必須パラメーターなし、オプションで backfill パラメーター。
ルールは個別に管理 | ストリーミング接続に必須パラメーターなし。レスポンス形式を定義するオプションパラメーターと、Academic Research アクセスの[バックフィルリカバリ機能](/x-api/fundamentals/recovery-and-redundancy)を追加可能。
ルールは個別に管理 |
| 配信タイプ | Streaming | Streaming
REST(ルール管理用) | Streaming
REST(ルール管理用) |
| デフォルトのリクエストレート制限 | 5 分あたり 5 回の接続試行 | POST と GET の両方のリクエストを合算して 1 分あたり 60 リクエスト
/rules: 1 分あたり 60 リクエスト。特定ストリームの API に対する /rules エンドポイントへのすべてのリクエスト(POST と GET)で合算。 | エンドポイントによる。現在の上限は[レート制限](/x-api/fundamentals/rate-limits)を参照。 |
| 最大許容接続数 | 認可済みユーザーあたり同時 2 | 契約により決定、複数/冗長接続をサポート | Pay-per-use: 1 |
| [リカバリと冗長性機能](/x-api/fundamentals/recovery-and-redundancy) | なし | Backfill、冗長接続、Replay API | |
| Keep-alive シグナル / ハートビート | 少なくとも 20 秒ごとに空行 (\r\n など) | 10 秒ごとに空行 (\r\n など) | 少なくとも 20 秒ごとに空行 (\r\n など) |
| レイテンシ | 10 秒 | 2 秒
URL アンワインディングエンリッチメント使用時は少なくとも 10 秒 | 10 秒 |
| 最大許容ルール数 | 1 ルール(エンドポイント接続リクエスト内) | 契約により決定、最大 250,000 | Pay-per-use: 1,000 ルール |
| ルールフィルターの制限 | 接続あたり 1 クエリ、最大で以下のいずれか:
- 400 の track キーワード
- 5000 の follow ユーザー ID
- 25 の location box | ルールあたり最大 2,048 文字 | Pay-per-use: ルールあたり 1,024 文字 |
| [Post JSON フォーマット](/x-api/fundamentals/data-dictionary) | Standard v1.1 フォーマット | [Native Enriched](/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-tweet-object) または Activity Streams([コンソール](/x-api/enterprise-gnip-2.0/fundamentals/overview)で選択) | [X API v2 フォーマット](/x-api/fundamentals/data-dictionary)(**fields** および **expansions** リクエストパラメーターで決定、v1.1 フォーマットとは後方互換性なし)
Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法については、[データフォーマット移行ガイド](/x-api/migrate/data-format-migration)を参照してください。Native Enriched と Activity Streams のデータフォーマット移行ガイドは近日中に公開予定です。 |
| 投稿の編集履歴とメタデータを提供 | ✔ | ✔ | ✔ |
| 独自の機能 | 接続リクエストのクエリパラメーターでフィルタリング
設定 UI なし | 独立したエンドポイントで作成したルールでフィルタリング
契約で利用可能な[エンリッチメント](/x-api/enterprise-gnip-2.0/enterprise-gnip#enrichments)機能
console.gnip.com UI での設定 | 独立したエンドポイントで作成した[ルール](/x-api/posts/filtered-stream/integrate/build-a-rule)でフィルタリング
[メトリクス](/x-api/fundamentals/metrics)と URL エンリッチメント機能を含む
オブジェクトの [fields](/x-api/fundamentals/fields) と [expansions](/x-api/fundamentals/expansions) をリクエストパラメーターで指定
Post [Annotations](/x-api/fundamentals/post-annotations)
[Conversation ID](/x-api/fundamentals/conversation-id) 演算子とフィールド
[Developer Console](/resources/fundamentals/developer-portal) で設定 |