Account Activity API

Webhook を通じてアカウントアクティビティのリアルタイムイベントを受信する

Account Activity API は、アカウントアクティビティに関するイベントをリアルタイムで webhook に送信します。ユーザーアカウントを購読すると、そのユーザーがポストしたとき、DM を受信したとき、フォローされたときなどに通知を受け取ることができます。

​

概要

Webhook 配信

イベントをサーバーに配信

リアルタイム

即時のイベント通知

包括的

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

サブスクリプション型

ユーザーアカウントを購読

---

​

仕組み

1. Webhook を登録 — Webhook URL を登録します
2. ユーザーをサブスクライブ — ユーザーのサブスクリプションを追加します
3. イベントを受信 — POST リクエストでアクティビティイベントを受信します
4. イベントを処理 — アプリケーションでイベントを処理します

---

​

イベント種別

カテゴリ	イベント
投稿	作成、削除、いいね、いいね解除
ダイレクトメッセージ	受信、送信、入力中インジケーターの表示
フォロー	フォロー、フォロー解除
ブロック	ブロック、ブロック解除
ミュート	ミュート、ミュート解除

---

​

Webhook のセキュリティ

すべての Webhook リクエストには次のものが含まれます。

• CRC 検証 — Webhook の正当性を検証します
• 署名ヘッダー — x-twitter-webhooks-signature
• HTTPS 必須 — すべての Webhook URL は HTTPS を使用する必要があります

---

​

例：webhook を登録する

curl -X POST "https://api.x.com/1.1/account_activity/all/env-name/webhooks.json?\
url=https%3A%2F%2Fyour-server.com%2Fwebhook" \
  -H "Authorization: OAuth oauth_consumer_key=..."

---

​

開始方法

前提条件

• 承認済みの開発者アカウント
• 開発者コンソール内の Project と App
• 外部からアクセス可能な HTTPS webhook エンドポイント

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

webhook に代わるストリーミング方式

移行ガイド

v1.1 からの移行

APIリファレンス

エンドポイントに関する詳細なドキュメント