イベントストリーミングのための X Activity API クイックスタートガイド

このガイドでは、X Activity API エンドポイントを使用してイベントをサブスクライブし受信する方法を説明します。一般的に 3 つのステップがあります:

イベントをフィルタリングしたいユーザーの User ID を特定する
そのユーザーに対してフィルタリングしたいイベントタイプのサブスクリプションを作成する
Webhook または永続的な HTTP ストリーム接続を使ってイベントを受信する

前提条件始める前に、次のものが必要です:

承認済みアプリを持つ開発者アカウント
アプリの Bearer Token

ユーザー ID の取得

サブスクリプションを作成する前に、フィルタリングしたいアカウントのユーザー ID を知る必要があります。この例では、XDevelopers ハンドルを使用します。ユーザー ID は、以下を含むいくつかの方法でルックアップできます: ユーザー名でユーザー ID をルックアップ:

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" "https://api.x.com/2/users/by/username/xdevelopers"

自分自身のユーザー ID を取得:

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" https://api.x.com/2/users/me

どちらのエンドポイントも、サブスクリプションフィルターで使用できる id フィールドを含むユーザー情報を返します。JSON レスポンスの例は以下のとおりです:

{
    "data": {
        "id": "2244994945",
        "name": "Developers",
        "username": "XDevelopers"
    }
}

サブスクリプションの作成

次のステップはサブスクリプションを作成することです。この例では、XDevelopers の bio 更新をサブスクライブします。そのためには、user_id と event_type を JSON ボディで渡します。この場合、event_type は profile.update.bio です。 X Developer のユーザー ID: 2244994945 と、オプションのタグを渡します:

{
  "event_type": "profile.update.bio",
  "filter": {
    "user_id": "2244994945"
  },
  "tag": "Xdevelopers' bio updates"
}

認可には (developer portal からの) bearer token を使用します。app-only bearer token は、このような公開イベントに対して機能します。一部のイベントは非公開で、代わりに user-context (OAuth 2.0) 認証が必要です — 詳しくはイベントのプライバシーと認証を参照してください。

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  https://api.x.com/2/activity/subscriptions \
  -X POST \
  -d '{
    "event_type": "profile.update.bio",
    "filter": {
      "user_id": "2244994945"
    },
    "tag": "Xdevelopers' bio updates"
  }'

リクエストが成功すると、サブスクリプションが作成されます:

profile.update.bio

{
  "data":[
    {
      "created_at":"2025-10-09T16:35:08.000Z",
      "event_type":"profile.update.bio",
      "filter":{
        "user_id":"2244994945"
      },
      "subscription_id":"1976325569252868096",
      "tag": "Xdevelopers' bio updates",
      "updated_at":"2025-10-09T16:35:08.000Z"
    }
  ],
  "meta": {
    "total_subscriptions": 1
  }
}

イベントの取得

サブスクリプションを作成したら、Webhook または永続的な HTTP ストリーム経由でイベントを受信できます。この例では、永続的な HTTP ストリームを開きます:

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

Xdevelopers アカウントがプロフィール bio を更新すると、イベントがストリーム経由で配信されます:

profile.update.bio

{
  "data": {
    "filter": {
      "user_id": "2244994945"
    },
    "event_type": "profile.update.bio",
    "tag": "Xdevelopers' bio updates",
    "payload": {
      "before": "Mars & Cars",
      "after": "Mars, Cars & AI"
    }
  }
}

サブスクリプション管理

X Activity API は、標準的な CRUD 操作を通じてサブスクリプションを管理するエンドポイントを提供します。

サブスクリプションの作成

イベントを受信するための新しいサブスクリプションを作成します:

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -X POST \
  https://api.x.com/2/activity/subscriptions \
  -d '{
    "event_type": "profile.update.bio",
    "filter": {
      "user_id": "123456789"
    },
    "tag": "my bio updates",
    "webhook_id": "1976325569252868099"
  }'

tag フィールドはオプションです。配信時にイベントを識別するのに役立ちます。
webhook_id フィールドもオプションです。Webhook をセットアップする方法は webhook ドキュメントを参照してください。webhook_id が指定されている場合、イベントは提供された Webhook に配信され、ストリームが開いている場合はストリームにも配信されます。

レスポンス:

profile.update.bio

{
  "data": {
    "subscription_id": "1976325569252868096",
    "event_type": "profile.update.bio",
    "filter": {
      "user_id": "123456789"
    },
    "created_at": "2025-10-09T16:35:08.000Z",
    "updated_at": "2025-10-09T16:35:08.000Z",
    "tag": "my bio updates",
    "webhook_id": "1976325569252868099"
  }
}

サブスクリプションの一覧表示

アプリケーションのすべてのアクティブなサブスクリプションを取得します:

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

レスポンス:

profile.update.bio

{
  "data": [
    {
      "subscription_id": "1976325569252868096",
      "event_type": "profile.update.bio",
      "filter": {
        "user_id": "123456789"
      },
      "created_at": "2025-10-09T16:35:08.000Z",
      "updated_at": "2025-10-10T03:50:59.000Z"
    },
    {
      "subscription_id": "1976325569252868097",
      "event_type": "profile.update.profile_picture",
      "filter": {
        "user_id": "987654321"
      },
      "created_at": "2025-10-08T14:35:08.000Z",
      "updated_at": "2025-10-08T14:35:08.000Z"
    }
  ],
  "meta": {
    "total_subscriptions": 2
  }
}

サブスクリプションの削除

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

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -X DELETE \
  https://api.x.com/2/activity/subscriptions/1976325569252868096

レスポンス:

{
  "data": {
    "deleted": true
  },
  "meta": {
    "total_subscriptions": 0
  }
}

total_subscriptions は、削除操作後にアプリに関連付けられている残りのサブスクリプション数を示します。

サブスクリプションの更新

PUT エンドポイントを使用すると、サブスクリプションの配信方法やタグを更新できます。 filter または event_type の更新には、既存のサブスクリプションを削除して新しいものを追加する必要があります。

curl -H "Authorization: Bearer YOUR_BEARER_TOKEN" \
  -X PUT \
  https://api.x.com/2/activity/subscriptions/1976325569252868096 \
  -d '{
    "tag": "my new tag",
    "webhook_id": "192846273860294839"
  }'

レスポンス:

profile.update.bio

{
  "data": {
    "subscription_id": "1976325569252868096",
    "event_type": "profile.update.bio",
    "filter": {
      "user_id": "123456789"
    },
    "created_at": "2025-10-09T16:35:08.000Z",
    "updated_at": "2025-10-10T17:10:58.000Z",
    "tag": "my new tag",
    "webhook_id": "192846273860294839"
  },
  "meta": {
    "total_subscriptions": 1
  }
}

次のステップ

イベントペイロード

各アクティビティイベントタイプのサンプル JSON

API リファレンス

完全なエンドポイントドキュメント

Webhooks

Webhook 配信をセットアップ

Getting Started

Products

Fundamentals

Partners & Customers

Resources

イベントストリーミングのための X Activity API クイックスタートガイド

ユーザー ID の取得

サブスクリプションの作成

イベントの取得

サブスクリプション管理

サブスクリプションの作成

サブスクリプションの一覧表示

サブスクリプションの削除

サブスクリプションの更新

次のステップ

イベントペイロード

API リファレンス

Webhooks

​ユーザー ID の取得

​サブスクリプションの作成

​イベントの取得

​サブスクリプション管理

​サブスクリプションの作成

​サブスクリプションの一覧表示

​サブスクリプションの削除

​サブスクリプションの更新

​次のステップ

イベントペイロード

API リファレンス

Webhooks

ユーザー ID の取得

サブスクリプションの作成

イベントの取得

サブスクリプション管理

サブスクリプションの作成

サブスクリプションの一覧表示

サブスクリプションの削除

サブスクリプションの更新

次のステップ