> ## 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 Webhooks API

> Filtered stream エンドポイントグループを使用すると、開発者は公開 Post のストリームをフィルタリングできます。X API v2 standard tier の stream に関するリファレンスです。

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

## 概要

Filtered stream エンドポイントグループを使用すると、開発者は公開 Post のストリームをフィルタリングできます。このエンドポイントグループの機能には、ルールの作成と管理、およびそれらのルールを適用して該当する公開 Post を返す Post ストリームのフィルタリングを可能にする複数のエンドポイントが含まれます。このエンドポイントグループを使用すると、特定のトピックやイベントをリッスンしたり、コンペティションを取り巻く会話を監視したり、トレンドがどのように発展するかを理解したりできます。

開発者は REST の [rules エンドポイント](/x-api/stream/get-stream-rules)を使用して、定義した条件に一致する Post をフィルタリングするためのルールを追加および削除できます。これらの[ルール](/x-api/posts/filtered-stream/integrate/build-a-rule)は、メッセージのキーワード、ハッシュタグ、URL などの Post 属性に一致するオペレーターで作成できます。オペレーターとルール節はブール論理と括弧で組み合わせて、フィルタのマッチング動作を細かく設定できます。

一連のルールを追加すると、Webhook を登録して、X が Post オブジェクトを JSON 形式で配信し始めます。Webhook に配信されるのは、ルールに一致するコンテンツのみです。

このエンドポイントは編集済み Post をサポートします。Webhook は、フィルターに 1 つ以上一致する編集済み Post を、その編集履歴(Post ID の配列を含む)とともに受け取ります。編集履歴のない Post の場合、この配列には 1 つの ID のみが含まれます。編集された Post の場合、この配列には複数の ID が含まれ、編集順を反映して昇順に並べられ、最新バージョンが配列の最後の位置になります。Post の編集の仕組みについて詳しくは、[Post 編集の基礎](/x-api/fundamentals/edit-posts)ページを参照してください。

**注意:** このエンドポイントグループは、ルールを設定する点で [v2 filtered stream エンドポイント](/x-api/posts/filtered-stream/introduction)と似ています。唯一の違いは、ルールに一致する Post の配信メカニズムです。

* v2 filtered stream エンドポイントの場合、永続的な接続を確立し、ルールに一致する Post をリッスンする必要があります。
* この filtered stream webhook エンドポイントの場合、Webhook を登録すると、X がルールに一致する Post を Webhook に配信します。

これにより、クライアント側のドロップやサーバー側の通常の再起動によるドロップに起因する切断を処理する必要がなくなります。1 秒あたり数百のイベントを配信する可能性があるため、Webhook サーバーがこれらの同時接続を処理できる必要があります。

このエンドポイントは現在 Enterprise 開発者向けに提供されており、次の構成をサポートします:

* プロジェクトあたり 25,000 以上のルール
* ルール作成時にすべてのオペレーターを使用可能
* 最大 2048 文字のルールを作成可能
* Enterprise アクセスの申請は[こちら](/forms/enterprise-api-interest)

Filtered stream から返される Post は、月間の [Post cap](/x-api/fundamentals/post-cap) にカウントされます。

<Note>
  **アカウントのセットアップ**

  これらのエンドポイントにアクセスするには、次のものが必要です:

  * 承認済みの[開発者アカウント](https://developer.x.com/en/portal/petition/essential/basic-info)
  * [プロジェクト](/resources/fundamentals/developer-apps)内にある[開発者アプリ](/resources/fundamentals/developer-apps)のキーとトークンで認証すること

  X API v2 エンドポイントへのアクセスの取得について詳しくは、[はじめにガイド](/x-api/getting-started/getting-access)をご覧ください。
</Note>

<div className="flex">
  <Button href="/x-api/posts/filtered-stream/quickstart">
    クイックスタート
  </Button>
</div>