メインコンテンツへスキップ
フィルタードストリームのエンドポイントグループは、開発者が公開Postのストリームをフィルタリングできるようにします。このエンドポイントグループには、ルールの作成・管理を行い、それらのルールを適用して一致する公開Postのみを返すようストリームをフィルタリングできる複数のエンドポイントが含まれます。これにより、特定のトピックやイベントの監視、コンペティションに関する会話のモニタリング、トレンドの形成過程の把握などが可能になります。 開発者は、切断せずに永続的なストリーム接続にルールを追加・削除するために、RESTのルールエンドポイントを使用できます。これらのルールは、メッセージのキーワード、ハッシュタグ、URLなどのPost属性にマッチするオペレーターで作成できます。オペレーターやルール句は、ブールロジックや括弧と組み合わせて、フィルタのマッチング動作をより精緻に調整できます。 ルールを一通り追加したら、永続的なHTTPストリーミング接続を通じてJSON形式でPostオブジェクトの配信を開始するストリーミング接続を確立できます。ストリームに接続している間は、ルールに一致するコンテンツのみが配信されます。 また、Filtered Streamをwebhookにリンクし、webhookイベントとして配信することもできます。Filtered Streamでのwebhookの利用について詳しくは、Filtered Stream Webhooksの概要をご覧ください。 フィルタード検索エンドポイントは、編集されたPostをサポートします。このエンドポイントは、1つ以上のフィルタに一致する編集済みのPostを、その編集履歴(Post IDの配列を含む)とともに配信します。編集履歴がないPostの場合、この配列には単一のIDが入ります。編集されたPostの場合、この配列には複数のIDが含まれ、編集の順序を反映した昇順で並び、配列の最後に最新バージョンが配置されます。Postの編集の仕組みについては、Posts editsの基礎ページをご覧ください。 フィルタードストリームエンドポイントの一部の機能は、アクセスレベルによって制限されます。 プロアクセス
  • プロジェクトあたり1000個のルール
  • POST /2/tweets/search/stream/rulesエンドポイントでルールを追加する場合、15分あたり100リクエスト
  • ルール作成時にすべてのオペレーターを使用可能
  • 最大1024文字までのルールを作成可能
エンタープライズアクセス
  • プロジェクトあたり25,000個以上のルール
  • ルール作成時にすべてのオペレーターを使用可能
  • 最大2048文字までのルールを作成可能
  • エンタープライズアクセスの申請はこちら
フィルタードストリームから返されるPostは、月間のPost上限に算入されます。
アカウントの設定これらのエンドポイントにアクセスするには、次が必要です。X API v2エンドポイントへのアクセス方法の詳細は、はじめにガイドをご覧ください。