クイックスタート

アクティビティストリームのサブスクリプションを設定してイベントを受信する

このガイドでは、リアルタイムのアカウントアクティビティイベントを受信するためのアクティビティストリームサブスクリプションの設定方法を説明します。

前提条件

始める前に、次のものが必要です。

• 承認済みの App を持つ開発者アカウント
• App のベアラートークン

---

1. サブスクリプションを作成する

   ユーザーのアクティビティイベントをサブスクライブします。

   cURL

   curl -X POST "https://api.x.com/2/activity/subscriptions" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/subscriptions"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   レスポンス:

   {
     "data": {
       "id": "1234567890",
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"],
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   
2. ストリームに接続する

   イベントを受信するために、永続的な接続を開きます。

   cURL

   curl "https://api.x.com/2/activity/stream" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Python

   import requests
   
   bearer_token = "YOUR_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"))
   
3. 受信イベントを処理する

   イベントは JSON オブジェクトとしてストリームされます。

   {
     "for_user_id": "2244994945",
     "event_type": "tweet_create_events",
     "created_at": "2024-01-15T10:30:00.000Z",
     "tweet_create_events": [
       {
         "id": "1234567890",
         "text": "Hello from the stream!",
         "author_id": "2244994945"
       }
     ]
   }
   

---

​

利用可能なイベントタイプ

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

---

​

サブスクリプションを管理する

サブスクリプションを一覧表示する

すべての有効なサブスクリプションを取得します:

curl "https://api.x.com/2/activity/subscriptions" \
  -H "Authorization: Bearer $BEARER_TOKEN"

サブスクリプションを更新する

サブスクリプションのイベントタイプを変更します:

curl -X PUT "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_types": ["tweet_create_events", "favorite_events"]
  }'

サブスクリプションを削除する

サブスクリプションを削除します:

curl -X DELETE "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

次のステップ

Account Activity API

Webhookベースの代替API

APIリファレンス

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