アクティビティストリーム

リアルタイムでアカウントアクティビティイベントをストリーミングする

Activity Stream エンドポイントは、サブスクライブしているユーザーのアカウントアクティビティイベントをリアルタイムで配信します。ユーザーがポスト、いいね、フォロー、DM の受信などを行った際のイベントを受信できます。

​

概要

リアルタイム

イベントを即時配信

包括的

投稿、いいね、フォロー、DM など

サブスクリプション型

ユーザーアクティビティを購読

Webhook 配信

イベントをあなたのサーバーに配信

---

​

イベントタイプ

イベント	説明
tweet_create_events	ユーザーが新しいポストを作成する
favorite_events	ユーザーがポストにいいねする
follow_events	ユーザーがフォローする、またはフォローされる
direct_message_events	ユーザーがDMを送信または受信する
block_events	ユーザーがブロックまたはブロック解除する
mute_events	ユーザーがミュートまたはミュート解除する

---

​

エンドポイント

メソッド	エンドポイント	説明
GET	/2/activity/stream	アクティビティストリームに接続
POST	/2/activity/subscriptions	サブスクリプションを作成
GET	/2/activity/subscriptions	サブスクリプションの一覧を取得
PUT	/2/activity/subscriptions/:id	サブスクリプションを更新
DELETE	/2/activity/subscriptions/:id	サブスクリプションを削除

---

​

仕組み

1. サブスクリプションを作成 — ユーザーアクティビティの購読を開始する
2. ストリームに接続 — 持続的な接続を確立する
3. イベントを受信 — リアルタイムのアクティビティイベントを取得する
4. イベントを処理 — アプリケーション側でイベントを処理する

---

​

例：ストリームに接続する

import requests

def stream_activity(bearer_token):
    url = "https://api.x.com/2/activity/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"))

---

​

はじめに

前提条件

• 承認済みの開発者アカウント
• 開発者コンソール内のProject と App
• App のベアラートークン

クイックスタート

最初のサブスクリプションを設定する

Account Activity API

Webhook ベースの代替手段

APIリファレンス

エンドポイントの詳細ドキュメント