フィルタ済みストリーム

フィルタールールにマッチする投稿をリアルタイムでストリーミングする

Filtered Stream エンドポイントを使用すると、フィルタールールに一致する投稿をリアルタイムで受信できます。強力なオペレーターを使ってルールを作成し、永続ストリームに接続して、投稿が公開され次第、一致するものを受信します。

概要

リアルタイム配信

公開から数秒以内に投稿を受信できます

永続的なルール

接続を維持したままルールを追加・削除できます

強力な検索演算子

キーワード、ハッシュタグ、ユーザーなどにマッチできます

Webhook 配信

必要に応じて Webhook 経由で投稿を受信できます

---

仕組み

1. ルールを作成する — 演算子を使用してフィルタールールを定義します
2. ストリームに接続する — 永続的な HTTP 接続を確立します
3. 投稿を受信する — 一致する投稿をリアルタイムで受信します

┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│ Create/     │      │ Connect to  │      │ Receive     │
│ manage      │  →   │ streaming   │  →   │ matching    │
│ rules       │      │ endpoint    │      │ Posts       │
└─────────────┘      └─────────────┘      └─────────────┘

---

エンドポイント

Method	Endpoint	説明
GET	/2/tweets/search/stream	ストリームに接続する
POST	/2/tweets/search/stream/rules	ルールを追加または削除する
GET	/2/tweets/search/stream/rules	現在のルールを一覧表示する

---

アクセスレベル

機能	従量課金	Enterprise
プロジェクトごとのルール数	1,000	25,000+
ルールの長さ	1,024文字	2,048文字
同時接続数	1	複数
全オペレーター対応	✓	✓

Enterprise についてお問い合わせ

より高い上限と追加機能をご利用いただけます

---

ルールの作成

ルールでは、検索クエリと同じ演算子を使用できます。

(AI OR "machine learning") lang:en -is:retweet

ルールの例

ルール	一致する投稿
#python	#python ハッシュタグが付いた投稿
from:elonmusk	@elonmusk による投稿
"breaking news" has:images	指定フレーズと画像を含む投稿
(@XDevelopers OR @X) -is:retweet	メンションを含む投稿 (リツイートを除く)

ルールを作成する

ルールの構文と演算子について学ぶ

---

ストリームへの接続

投稿を受信するために、永続的な HTTP 接続を確立します。

import requests

def stream_posts(bearer_token):
    url = "https://api.x.com/2/tweets/search/stream"
    headers = {"Authorization": f"Bearer {bearer_token}"}
    
    response = requests.get(url, headers=headers, stream=True)
    
    for line in response.iter_lines():
        if line:
            print(line.decode("utf-8"))

キープアライブ信号

ストリームは接続を維持するために、20秒ごとに空行 (\r\n) のみを送信します。20秒間データやキープアライブ信号を受信しない場合は、再接続してください。

切断の処理

スムーズに再接続する

ストリーミングデータの処理

投稿を効率的に処理する

---

Webhook 配信

常時接続を維持する代わりに、Webhook を使用して投稿を受信できます。

Webhook 配信

フィルタ済みストリーム用の Webhook 配信を設定する

---

ポストの編集

このストリームは、編集履歴とともに編集済みの投稿を配信します。編集のたびに新しいポストIDが生成されます。

{
  "data": {
    "id": "1234567893",
    "text": "Hello world! (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891", "1234567893"]
  }
}

ポスト編集の基本

ポストの編集についてさらに詳しく学ぶ

---

はじめに

前提条件

• 承認済みの開発者アカウント
• 開発者コンソールで作成された Project と App
• あなたの App のベアラートークン

クイックスタート

数分でストリームに接続

ルールを作成

ルール構文を学ぶ

オペレーターリファレンス

利用可能なすべてのオペレーター

サンプルコード

実行可能なコード例

---

高度なトピック

切断時の処理

スムーズに再接続する

高トラフィック対応

高スループットに対応する

復旧と冗長性

堅牢なアプリケーションを構築する

返された投稿の照合

どのルールにマッチしたか特定する