メインコンテンツへスキップ
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=..."

​
開始方法

前提条件

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

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

移行ガイド

v1.1 からの移行

APIリファレンス

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