X Activity API イベントペイロードの例

X Activity API が配信するイベント（永続 HTTP ストリームまたは webhook 経由）は、共通のエンベロープを共有します。

フィールド	説明
`event_uuid`	このイベント配信の一意な識別子
`filter`	マッチしたフィルター（例：`user_id` または `keyword`）
`event_type`	購読しているイベントタイプ
`tag`	サブスクリプションで設定した任意のタグ（設定されている場合）
`payload`	イベント固有のデータ
`includes`	利用可能な場合の展開オブジェクト（ユーザー、ツイートなど）

post.create

{
  "data": {
    "event_uuid": "2080761390344937796",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "post.create",
    "tag": "my post create",
    "payload": {},
    "includes": {}
  }
}

以下の例は、代表的な実際のペイロードです。フィールドの提供可否は、アカウント設定、展開、配信時点のオブジェクトの状態によって異なる場合があります。サポートされるイベントタイプと認証要件の全リストについては、はじめにを参照してください。

Post イベント

`post.create`

フィルター対象のユーザーが Post を作成したときに発火します。payload は Post オブジェクトで、includes には関連するユーザーやツイートが含まれる場合があります。

post.create

{
  "data": {
    "event_uuid": "2080761390344937796",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "post.create",
    "tag": "my post create",
    "payload": {
      "public_metrics": {
        "retweet_count": 0,
        "retweet_count_str": "0",
        "reply_count": 0,
        "reply_count_str": "0",
        "like_count": 0,
        "like_count_str": "0",
        "quote_count": 0,
        "quote_count_str": "0",
        "bookmark_count": 0,
        "bookmark_count_str": "0",
        "impression_count": 0,
        "impression_count_str": "0"
      },
      "lang": "en",
      "created_at": "2026-07-24T21:05:48.000Z",
      "author_id": "1716450569358098432",
      "reply_settings": "everyone",
      "display_text_range": [
        0,
        34
      ],
      "paid_partnership": false,
      "id": "2080761390344937796",
      "possibly_sensitive": false,
      "edit_history_tweet_ids": [
        "2080761390344937796"
      ],
      "conversation_id": "2080761390344937796",
      "text": "XAA docs payload sample 1784927148",
      "edit_controls": {
        "edits_remaining": 5,
        "edits_remaining_str": "5",
        "is_edit_eligible": true,
        "editable_until": "2026-07-24T22:05:48.000Z"
      }
    },
    "includes": {
      "tweets": [
        {
          "public_metrics": {
            "retweet_count": 0,
            "retweet_count_str": "0",
            "reply_count": 0,
            "reply_count_str": "0",
            "like_count": 0,
            "like_count_str": "0",
            "quote_count": 0,
            "quote_count_str": "0",
            "bookmark_count": 0,
            "bookmark_count_str": "0",
            "impression_count": 0,
            "impression_count_str": "0"
          },
          "lang": "en",
          "created_at": "2026-07-24T21:05:48.000Z",
          "author_id": "1716450569358098432",
          "reply_settings": "everyone",
          "display_text_range": [
            0,
            34
          ],
          "paid_partnership": false,
          "id": "2080761390344937796",
          "possibly_sensitive": false,
          "edit_history_tweet_ids": [
            "2080761390344937796"
          ],
          "conversation_id": "2080761390344937796",
          "text": "XAA docs payload sample 1784927148",
          "edit_controls": {
            "edits_remaining": 5,
            "edits_remaining_str": "5",
            "is_edit_eligible": true,
            "editable_until": "2026-07-24T22:05:48.000Z"
          }
        }
      ],
      "users": [
        {
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/OS6XL5y4m6",
                  "expanded_url": "https://console.x.com",
                  "display_url": "console.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 29,
                  "start_str": "29",
                  "end": 36,
                  "end_str": "36",
                  "username": "google"
                },
                {
                  "start": 38,
                  "start_str": "38",
                  "end": 47,
                  "end_str": "47",
                  "username": "coinbase"
                },
                {
                  "start": 49,
                  "start_str": "49",
                  "end": 51,
                  "end_str": "51",
                  "username": "X"
                },
                {
                  "start": 52,
                  "start_str": "52",
                  "end": 64,
                  "end_str": "64",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "name": "Taylor",
          "protected": false,
          "verified": true,
          "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
          "is_identity_verified": true,
          "affiliation": {
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X",
            "user_id": [
              "783214"
            ],
            "description": "X"
          },
          "location": "Palo Alto, CA",
          "username": "taycaldwell",
          "verified_type": "blue",
          "pinned_tweet_id": "1968451310203859083",
          "created_at": "2023-10-23T13:44:53.000Z",
          "id": "1716450569358098432",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg",
          "url": "https://t.co/OS6XL5y4m6",
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
          "most_recent_tweet_id": "2080761390344937796",
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 652,
            "following_count_str": "652",
            "tweet_count": 790,
            "tweet_count_str": "790",
            "listed_count": 47,
            "listed_count_str": "47",
            "like_count": 8011,
            "like_count_str": "8011",
            "media_count": 79,
            "media_count_str": "79"
          },
          "profile_geo_enrichment": {
            "potential_locations": [
              {
                "geo_entity": {
                  "entity_id": "5380748",
                  "display_name": "Palo Alto, California, United States",
                  "country_code": "US",
                  "region": "California",
                  "sub_region": "Santa Clara County",
                  "locality": "Palo Alto",
                  "population": 64403,
                  "population_str": "64403",
                  "geo_point": {
                    "latitude": 37.44188,
                    "longitude": -122.14302
                  }
                }
              }
            ]
          }
        }
      ]
    }
  }
}

`post.delete`

フィルター対象のユーザーが Post を削除したときに発火します。payload には削除された Post ID と author ID が含まれます。

post.delete

{
  "data": {
    "event_uuid": "-2781149976877970683",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "post.delete",
    "tag": "my post deletes",
    "payload": {
      "id": "2080761269309813134",
      "author_id": "1716450569358098432"
    },
    "includes": {
      "users": [
        {
          "data": {
            "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg",
            "affiliation": {
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "url": "https://twitter.com/X",
              "description": "X"
            },
            "protected": false,
            "id": "1716450569358098432",
            "username": "taycaldwell",
            "verified_type": "blue",
            "verified": true,
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
            "entities": {
              "url": {
                "urls": [
                  {
                    "start": 0,
                    "start_str": "0",
                    "end": 23,
                    "end_str": "23",
                    "url": "https://t.co/OS6XL5y4m6",
                    "expanded_url": "https://console.x.com",
                    "display_url": "console.x.com"
                  }
                ]
              },
              "description": {
                "mentions": [
                  {
                    "start": 29,
                    "start_str": "29",
                    "end": 36,
                    "end_str": "36",
                    "username": "google"
                  },
                  {
                    "start": 38,
                    "start_str": "38",
                    "end": 47,
                    "end_str": "47",
                    "username": "coinbase"
                  },
                  {
                    "start": 49,
                    "start_str": "49",
                    "end": 51,
                    "end_str": "51",
                    "username": "X"
                  },
                  {
                    "start": 52,
                    "start_str": "52",
                    "end": 64,
                    "end_str": "64",
                    "username": "XDevelopers"
                  }
                ]
              }
            },
            "public_metrics": {
              "followers_count": 5502,
              "followers_count_str": "5502",
              "following_count": 651,
              "following_count_str": "651",
              "tweet_count": 789,
              "tweet_count_str": "789",
              "listed_count": 47,
              "listed_count_str": "47",
              "like_count": 8010,
              "like_count_str": "8010",
              "media_count": 79,
              "media_count_str": "79"
            },
            "url": "https://t.co/OS6XL5y4m6",
            "created_at": "2023-10-23T13:44:53.000Z",
            "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
            "is_identity_verified": true,
            "location": "Palo Alto, CA",
            "name": "Taylor"
          }
        }
      ]
    }
  }
}

`post.mention.create`

誰かがフィルター対象のユーザーを Post 内で @メンションしたときに発火します。プライベートイベント — ユーザーコンテキスト認証が必要です。

post.mention.create

{
  "data": {
    "event_uuid": "2080765813578191303",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "post.mention.create",
    "tag": "my post mentions",
    "payload": {
      "paid_partnership": false,
      "created_at": "2026-07-24T21:23:23.000Z",
      "edit_history_tweet_ids": [
        "2080765813578191303"
      ],
      "conversation_id": "2080765813578191303",
      "display_text_range": [
        0,
        16
      ],
      "edit_controls": {
        "edits_remaining": 5,
        "edits_remaining_str": "5",
        "is_edit_eligible": true,
        "editable_until": "2026-07-24T22:23:23.000Z"
      },
      "text": "hey @taycaldwell",
      "entities": {
        "mentions": [
          {
            "start": 4,
            "start_str": "4",
            "end": 16,
            "end_str": "16",
            "username": "taycaldwell",
            "id": "1716450569358098432"
          }
        ]
      },
      "author_id": "2046316926083764224",
      "possibly_sensitive": false,
      "public_metrics": {
        "retweet_count": 0,
        "retweet_count_str": "0",
        "reply_count": 0,
        "reply_count_str": "0",
        "like_count": 0,
        "like_count_str": "0",
        "quote_count": 0,
        "quote_count_str": "0",
        "bookmark_count": 0,
        "bookmark_count_str": "0",
        "impression_count": 0,
        "impression_count_str": "0"
      },
      "reply_settings": "everyone",
      "id": "2080765813578191303",
      "lang": "und"
    },
    "includes": {
      "users": [
        {
          "public_metrics": {
            "followers_count": 97,
            "followers_count_str": "97",
            "following_count": 1,
            "following_count_str": "1",
            "tweet_count": 50,
            "tweet_count_str": "50",
            "listed_count": 4,
            "listed_count_str": "4",
            "like_count": 26,
            "like_count_str": "26",
            "media_count": 3,
            "media_count_str": "3"
          },
          "profile_banner_url": "",
          "username": "paypertaylor2",
          "protected": false,
          "is_identity_verified": false,
          "affiliation": {
            "badge_url": "https://pbs.twimg.com/semantic_core_img/1428827730364096519/4ZXpTBhS?format=png&name=orig",
            "description": "Automated"
          },
          "most_recent_tweet_id": "2080765813578191303",
          "verified_type": "none",
          "description": "",
          "created_at": "2026-04-20T19:55:59.000Z",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2050311008334598144/EX0NG310_normal.jpg",
          "name": "paypertaylor2",
          "verified": false,
          "url": "",
          "id": "2046316926083764224"
        },
        {
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 651,
            "following_count_str": "651",
            "tweet_count": 789,
            "tweet_count_str": "789",
            "listed_count": 46,
            "listed_count_str": "46",
            "like_count": 8010,
            "like_count_str": "8010",
            "media_count": 79,
            "media_count_str": "79"
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028",
          "username": "taycaldwell",
          "protected": false,
          "is_identity_verified": true,
          "affiliation": {
            "user_id": [
              "783214"
            ],
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X",
            "description": "X"
          },
          "most_recent_tweet_id": "2080761269309813134",
          "verified_type": "blue",
          "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers",
          "pinned_tweet_id": "1968451310203859083",
          "created_at": "2023-10-23T13:44:53.000Z",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg",
          "name": "Taylor Caldwell",
          "verified": true,
          "url": "https://t.co/7SzJl0jTOo",
          "location": "San Francisco, CA",
          "id": "1716450569358098432",
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/7SzJl0jTOo",
                  "expanded_url": "https://developer.x.com",
                  "display_url": "developer.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 28,
                  "start_str": "28",
                  "end": 35,
                  "end_str": "35",
                  "username": "google"
                },
                {
                  "start": 37,
                  "start_str": "37",
                  "end": 46,
                  "end_str": "46",
                  "username": "coinbase"
                },
                {
                  "start": 48,
                  "start_str": "48",
                  "end": 50,
                  "end_str": "50",
                  "username": "X"
                },
                {
                  "start": 51,
                  "start_str": "51",
                  "end": 63,
                  "end_str": "63",
                  "username": "XDevelopers"
                }
              ]
            }
          }
        }
      ],
      "tweets": [
        {
          "paid_partnership": false,
          "created_at": "2026-07-24T21:23:23.000Z",
          "edit_history_tweet_ids": [
            "2080765813578191303"
          ],
          "conversation_id": "2080765813578191303",
          "display_text_range": [
            0,
            16
          ],
          "edit_controls": {
            "edits_remaining": 5,
            "edits_remaining_str": "5",
            "is_edit_eligible": true,
            "editable_until": "2026-07-24T22:23:23.000Z"
          },
          "text": "hey @taycaldwell",
          "entities": {
            "mentions": [
              {
                "start": 4,
                "start_str": "4",
                "end": 16,
                "end_str": "16",
                "username": "taycaldwell",
                "id": "1716450569358098432"
              }
            ]
          },
          "author_id": "2046316926083764224",
          "possibly_sensitive": false,
          "public_metrics": {
            "retweet_count": 0,
            "retweet_count_str": "0",
            "reply_count": 0,
            "reply_count_str": "0",
            "like_count": 0,
            "like_count_str": "0",
            "quote_count": 0,
            "quote_count_str": "0",
            "bookmark_count": 0,
            "bookmark_count_str": "0",
            "impression_count": 0,
            "impression_count_str": "0"
          },
          "reply_settings": "everyone",
          "id": "2080765813578191303",
          "lang": "und"
        }
      ]
    }
  }
}

Like イベント

`like.create`

フィルター対象のユーザーが Post に「いいね」したとき、またはそのユーザーの Post に「いいね」がついたときに発火します。プライベートイベント — ユーザーコンテキスト認証が必要です。オプションの direction フィルター（inbound または outbound）をサポートします。 payload は以下のフィールドを持つ like オブジェクトです。

フィールド	説明
`id`	いいねイベントの ID
`liked_tweet_id`	いいねされた Post の ID
`liked_tweet_author_id`	いいねされた Post の作成者
`created_at`	いいねされた Post の作成日時（利用可能な場合）
`timestamp_ms`	イベントのタイムスタンプ（ミリ秒、利用可能な場合）

includes にはいいねされた Post と関連するユーザーが含まれる場合があります。

like.create

{
  "data": {
    "event_uuid": "-3402274206530057851",
    "filter": {
      "user_id": "1716450569358098432",
      "direction": "outbound"
    },
    "event_type": "like.create",
    "tag": "my likes",
    "payload": {
      "id": "87719f50ee17bdfa06a3089098a2b9ed",
      "created_at": "2026-07-24T21:12:45.000Z",
      "timestamp_ms": "1784927565236",
      "liked_tweet_author_id": "2533341854",
      "liked_tweet_id": "2079814480427442556"
    },
    "includes": {
      "users": [
        {
          "description": "𝕏 | @X @API @XDevelopers",
          "pinned_tweet_id": "2040770361566826685",
          "url": "",
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/2533341854/1638372155",
          "created_at": "2014-05-29T20:24:26.000Z",
          "entities": {
            "description": {
              "mentions": [
                {
                  "start": 4,
                  "start_str": "4",
                  "end": 6,
                  "end_str": "6",
                  "username": "X"
                },
                {
                  "start": 7,
                  "start_str": "7",
                  "end": 11,
                  "end_str": "11",
                  "username": "API"
                },
                {
                  "start": 12,
                  "start_str": "12",
                  "end": 24,
                  "end_str": "24",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "public_metrics": {
            "followers_count": 26972,
            "followers_count_str": "26972",
            "following_count": 1713,
            "following_count_str": "1713",
            "tweet_count": 2994,
            "tweet_count_str": "2994",
            "listed_count": 297,
            "listed_count_str": "297",
            "like_count": 47468,
            "like_count_str": "47468",
            "media_count": 265,
            "media_count_str": "265"
          },
          "affiliation": {
            "description": "X",
            "url": "https://twitter.com/X",
            "user_id": [
              "783214"
            ],
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
          },
          "name": "Chris Park",
          "verified_type": "blue",
          "id": "2533341854",
          "profile_image_url": "https://pbs.twimg.com/profile_images/1770195415729569792/wUEX1LCO_normal.jpg",
          "username": "chrisparkX",
          "protected": false,
          "is_identity_verified": false,
          "location": "New York, NY",
          "verified": true,
          "profile_geo_enrichment": {
            "potential_locations": [
              {
                "geo_entity": {
                  "entity_id": "5128638",
                  "display_name": "New York, United States",
                  "country_code": "US",
                  "region": "New York",
                  "geo_point": {
                    "latitude": 43.00035,
                    "longitude": -75.4999
                  }
                }
              }
            ]
          }
        }
      ],
      "tweets": [
        {
          "possibly_sensitive": false,
          "edit_controls": {
            "edits_remaining": 5,
            "edits_remaining_str": "5",
            "is_edit_eligible": true,
            "editable_until": "2026-07-22T07:23:07.000Z"
          },
          "lang": "en",
          "text": "Great guide on using the X API via our new XMCP and Grok Build to build a structured knowledge system powered by X—unlocking great use cases like agentic research, realtime monitoring the situation, and an audience flywheel to improve as creators on X. https://t.co/5DedenNGo9",
          "conversation_id": "2079814480427442556",
          "created_at": "2026-07-22T06:23:07.000Z",
          "paid_partnership": false,
          "author_id": "2533341854",
          "entities": {
            "urls": [
              {
                "start": 253,
                "start_str": "253",
                "end": 276,
                "end_str": "276",
                "url": "https://t.co/5DedenNGo9",
                "expanded_url": "https://twitter.com/xfreeze/status/2079756440722665849",
                "display_url": "x.com/xfreeze/status…"
              }
            ]
          },
          "edit_history_tweet_ids": [
            "2079814480427442556"
          ],
          "id": "2079814480427442556",
          "public_metrics": {
            "retweet_count": 16,
            "retweet_count_str": "16",
            "reply_count": 8,
            "reply_count_str": "8",
            "like_count": 131,
            "like_count_str": "131",
            "quote_count": 2,
            "quote_count_str": "2",
            "bookmark_count": 90,
            "bookmark_count_str": "90",
            "impression_count": 21004,
            "impression_count_str": "21004"
          },
          "referenced_tweets": [
            {
              "type": "quoted",
              "id": "2079756440722665849"
            }
          ],
          "display_text_range": [
            0,
            252
          ],
          "reply_settings": "everyone"
        }
      ]
    }
  }
}

Follow イベント

`follow.follow`

フィルター対象のユーザーが他のユーザーをフォローしたとき、またはフォローされたときに発火します。payload には source（フォロワー）と target（フォローされるユーザー）が含まれます。

follow.follow

{
  "data": {
    "event_uuid": "-7953119945885597316",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "follow.follow",
    "tag": "my follows",
    "payload": {
      "source": {
        "data": {
          "affiliation": {
            "description": "X",
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X"
          },
          "location": "Palo Alto, CA",
          "name": "Taylor",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg",
          "created_at": "2023-10-23T13:44:53.000Z",
          "protected": false,
          "verified": true,
          "url": "https://t.co/OS6XL5y4m6",
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 652,
            "following_count_str": "652",
            "tweet_count": 790,
            "tweet_count_str": "790",
            "listed_count": 47,
            "listed_count_str": "47",
            "like_count": 8010,
            "like_count_str": "8010",
            "media_count": 79,
            "media_count_str": "79"
          },
          "is_identity_verified": true,
          "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
          "verified_type": "blue",
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/OS6XL5y4m6",
                  "expanded_url": "https://console.x.com",
                  "display_url": "console.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 29,
                  "start_str": "29",
                  "end": 36,
                  "end_str": "36",
                  "username": "google"
                },
                {
                  "start": 38,
                  "start_str": "38",
                  "end": 47,
                  "end_str": "47",
                  "username": "coinbase"
                },
                {
                  "start": 49,
                  "start_str": "49",
                  "end": 51,
                  "end_str": "51",
                  "username": "X"
                },
                {
                  "start": 52,
                  "start_str": "52",
                  "end": 64,
                  "end_str": "64",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
          "username": "taycaldwell",
          "id": "1716450569358098432"
        }
      },
      "target": {
        "data": {
          "affiliation": {
            "description": "X",
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X"
          },
          "name": "API",
          "profile_image_url": "https://pbs.twimg.com/profile_images/1683497657388392455/yW7azZHt_normal.jpg",
          "created_at": "2007-05-23T06:01:13.000Z",
          "protected": false,
          "verified": true,
          "url": "https://t.co/YrfsitXdac",
          "public_metrics": {
            "followers_count": 4934564,
            "followers_count_str": "4934564",
            "following_count": 12,
            "following_count_str": "12",
            "tweet_count": 3755,
            "tweet_count_str": "3755",
            "listed_count": 11603,
            "listed_count_str": "11603",
            "like_count": 7,
            "like_count_str": "7",
            "media_count": 9,
            "media_count_str": "9"
          },
          "is_identity_verified": false,
          "description": "Updates about X API changes and service issues.",
          "verified_type": "business",
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/YrfsitXdac",
                  "expanded_url": "https://developer.x.com",
                  "display_url": "developer.x.com"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1690212094",
          "username": "API",
          "id": "6253282"
        }
      }
    }
  }
}

`follow.unfollow`

フィルター対象のユーザーが他のユーザーのフォローを解除したとき、またはフォロー解除されたときに発火します。source / target の形状は follow.follow と同じです。

follow.unfollow

{
  "data": {
    "event_uuid": "-4233426745281461957",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "follow.unfollow",
    "tag": "my unfollows",
    "payload": {
      "source": {
        "data": {
          "affiliation": {
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X",
            "description": "X"
          },
          "url": "https://t.co/OS6XL5y4m6",
          "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
          "verified": true,
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/OS6XL5y4m6",
                  "expanded_url": "https://console.x.com",
                  "display_url": "console.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 29,
                  "start_str": "29",
                  "end": 36,
                  "end_str": "36",
                  "username": "google"
                },
                {
                  "start": 38,
                  "start_str": "38",
                  "end": 47,
                  "end_str": "47",
                  "username": "coinbase"
                },
                {
                  "start": 49,
                  "start_str": "49",
                  "end": 51,
                  "end_str": "51",
                  "username": "X"
                },
                {
                  "start": 52,
                  "start_str": "52",
                  "end": 64,
                  "end_str": "64",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
          "is_identity_verified": true,
          "username": "taycaldwell",
          "id": "1716450569358098432",
          "name": "Taylor",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg",
          "created_at": "2023-10-23T13:44:53.000Z",
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 651,
            "following_count_str": "651",
            "tweet_count": 790,
            "tweet_count_str": "790",
            "listed_count": 47,
            "listed_count_str": "47",
            "like_count": 8010,
            "like_count_str": "8010",
            "media_count": 79,
            "media_count_str": "79"
          },
          "verified_type": "blue",
          "location": "Palo Alto, CA",
          "protected": false
        }
      },
      "target": {
        "data": {
          "affiliation": {
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X",
            "description": "X"
          },
          "url": "https://t.co/YrfsitXdac",
          "description": "Updates about X API changes and service issues.",
          "verified": true,
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/YrfsitXdac",
                  "expanded_url": "https://developer.x.com",
                  "display_url": "developer.x.com"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1690212094",
          "is_identity_verified": false,
          "username": "API",
          "id": "6253282",
          "name": "API",
          "profile_image_url": "https://pbs.twimg.com/profile_images/1683497657388392455/yW7azZHt_normal.jpg",
          "created_at": "2007-05-23T06:01:13.000Z",
          "public_metrics": {
            "followers_count": 4934563,
            "followers_count_str": "4934563",
            "following_count": 12,
            "following_count_str": "12",
            "tweet_count": 3755,
            "tweet_count_str": "3755",
            "listed_count": 11603,
            "listed_count_str": "11603",
            "like_count": 7,
            "like_count_str": "7",
            "media_count": 9,
            "media_count_str": "9"
          },
          "verified_type": "business",
          "protected": false
        }
      }
    }
  }
}

Profile イベント

すべての profile.update.* イベントは、before / after の共通ペイロード形状を持ちます。サポートされるタイプ：profile.update.bio、profile.update.profile_picture、profile.update.banner_picture、profile.update.screenname、profile.update.handle、profile.update.geo、profile.update.url、profile.update.verified_badge、profile.update.affiliate_badge。

`profile.update.bio`

フィルター対象のユーザーがプロフィール自己紹介を更新したときに発火します。

profile.update.bio

{
  "data": {
    "event_uuid": "-8917909039855612786",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.bio",
    "tag": "my bio updates",
    "payload": {
      "before": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
      "after": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers"
    }
  }
}

`profile.update.profile_picture`

フィルター対象のユーザーがプロフィール画像を更新したときに発火します。

profile.update.profile_picture

{
  "data": {
    "event_uuid": "3497989179769309099",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.profile_picture",
    "tag": "my profile picture updates",
    "payload": {
      "before": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt.jpg",
      "after": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV.jpg"
    }
  }
}

`profile.update.banner_picture`

フィルター対象のユーザーがプロフィールバナーを更新したときに発火します。

profile.update.banner_picture

{
  "data": {
    "event_uuid": "5061407317112342192",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.banner_picture",
    "tag": "my banner updates",
    "payload": {
      "before": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
      "after": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028"
    }
  }
}

`profile.update.screenname`

フィルター対象のユーザーが表示名を更新したときに発火します。

profile.update.screenname

{
  "data": {
    "event_uuid": "4123434298221215973",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.screenname",
    "tag": "my display name updates",
    "payload": {
      "before": "Taylor",
      "after": "Taylor Caldwell"
    }
  }
}

`profile.update.geo`

フィルター対象のユーザーがプロフィールの所在地を更新したときに発火します。

profile.update.geo

{
  "data": {
    "event_uuid": "8309664692915093892",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.geo",
    "tag": "my location updates",
    "payload": {
      "before": "Palo Alto, CA",
      "after": "San Francisco, CA"
    }
  }
}

`profile.update.url`

フィルター対象のユーザーがプロフィールのウェブサイト URL を更新したときに発火します。

profile.update.url

{
  "data": {
    "event_uuid": "-6055744140117128555",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "profile.update.url",
    "tag": "my url updates",
    "payload": {
      "before": "https://t.co/OS6XL5y4m6",
      "after": "https://t.co/7SzJl0jTOo"
    }
  }
}

`profile.update.handle`

フィルター対象のユーザーが @ハンドルを更新したときに発火します。他のプロフィールイベントと同じ before / after のペイロード形状です。

`profile.update.verified_badge`

フィルター対象のユーザーの認証バッジが変更されたときに発火します。他のプロフィールイベントと同じ before / after のペイロード形状です。

`profile.update.affiliate_badge`

フィルター対象のユーザーのアフィリエイトバッジが変更されたときに発火します。他のプロフィールイベントと同じ before / after のペイロード形状です。

Chat イベント（XChat）

暗号化されたチャットのペイロードには、XChat クライアントライブラリで使用される不透明なエンコード済みフィールドが含まれます。プライベートイベント — ユーザーコンテキスト認証が必要です。

`chat.received`

chat.received

{
  "data": {
    "event_uuid": "8511582263942905822",
    "filter": {
      "user_id": "1830023695835787264"
    },
    "event_type": "chat.received",
    "tag": "my chat received",
    "payload": {
      "conversation_token": "eyJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0aW5nVXNlciI6ICIxODMwMDIzNjk1ODM1Nzg3MjY0IiwgInJlY2lwaWVudCI6ICIxMDM0MjAyMjcyMzEyNTA0MzIwIiwgInZhbGlkU2luY2VNU2VjIjogIjE3NDU4ODQ4MDAwMDAifQ.86ymJsmru5KJtNvlvNXCErgMeevqaNBgBvLiSZa_kbo",
      "id": "e4f4d3fc-8bbf-4928-92eb-e5058d6bb6f6",
      "created_at_msec": "1784841183370",
      "sender_id": "1034202272312504320",
      "conversation_id": "1034202272312504320:1830023695835787264",
      "conversation_key_version": "1768236281331",
      "encoded_event": "CwABAAAAEzIwODA0MDA4MjUyMjcxMDAxNjALAAIAAAAkZTRmNGQzZmMtOGJiZi00OTI4LTkyZWItZTUwNThkNmJiNmY2CwADAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5KbFkybHdhV1Z1ZENJNklDSXhNRE0wTWpBeU1qY3lNekV5TlRBME16SXdJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3ODQ4NDExODMzNzAMAAcMAAELAGQAAABTzxVCBCVAlguLYySJdcYhpgpUgQYshT8ZDGTu+ukrdsGGBQ26N5r2/TNd7FJ/znc64yz9gv6u6xdA4IlWu+C4ScjGYgJ+7A8nLxDREFtYvlmqlDQLAGUAAAANMTc2ODIzNjI4MTMzMQIAZgECAGkACABqAAAAAQwAbAsAAQAAACBKpTut+m1aRnpYRpLv2RT2EaZGCqyjz3jp9zZ2ldrO6QsAAgAAAEjpfQJPSWghOYDoroi35e0Au4Lp5ClsN0brEmBVp7wwZo6qX3PbnSsBD2tqV8gk7JDSMTvSMjndOjk/MMHwGsYDt6Fn9yNJ+NoAAgBtAAAADAAJCwABAAAAVjZJSzlTWklNWEJlNVNGY0I3dkdaSmQ1QTVFYjVNTHZud3JoVUZmQkd2NFM1R3NTWDNXV1BHdUluWFZOZlNsYTM2RWpYUVEvUi9IaHNBKzJoUEFFWTdBCwACAAAADTE3NjUzODI2MzQ4MTcLAAMAAAABNwsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVKMmMrM0JZWnM3WkNFWS9VUENwbVF4Sk85djZGSmpldXN2bVNaTy9KRWF5OG9GMStvWFhsSFY1NWtYNGJLNi96RmlqTkt2cTFZUmIwaXQweVhxYmdsQT09DwAFDAAAAAELAAEAAAATMTAzNDIwMjI3MjMxMjUwNDMyMAsAAgAAAA0xNzY1MzgyNjM0ODE3CwADAAAAfE1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUoyYyszQllaczdaQ0VZL1VQQ3BtUXhKTzl2NkZKamV1c3ZtU1pPL0pFYXk4b0YxK29YWGxIVjU1a1g0Yks2L3pGaWpOS3ZxMVlSYjBpdDB5WHFiZ2xBPT0AAAIACwELAA0AAAADMC0xAA==",
      "conversation_key_change_event": "CwABAAAAEzIwMTA3NTQ4MTkxMTY0NDk5MDULAAIAAAAkNGNlNjQ1ZDItYTg5YS00OTlmLThiZGUtZTBhMWY0M2QxOTFmCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3NjgyMzYyODE1NTkMAAcMAAMLAAEAAAANMTc2ODIzNjI4MTMzMQ8AAgwAAAACCwABAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAIAAACYQkVzU1pNTTZxMEhPM0FRVjlXWk52cWh0YndyblFpeE1zcEo5VkVZNmpvMVR2cFV1SmxjaE9GNVgxMFUrUStFRmMvZWZjMlpjYnRmSFR6ZFlzSDN2VExXdENJZE1qR1orZ0JGc0o4cEF1cmx6clR6ZkFPeVNPNWlYZEhBeVJ6c085TlV0TGZnUjJ4TWxJRVA2Y2M4bk1nUT0LAAMAAAANMTc2NTM4MjYzNDgxNwALAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAJhCRDdHZEdXYklaaHdQaEFQaFYwVktoKyswR2poR3l5QXp0Yk1jL0ZHSWYvbCtSYThpU3lhV2tROFpSVVJtT25aRnN5VzNwMjRiMFp1QWg3dkNjZlpOV2dOZ1hpQUJIZmYxL1RpVFdLZ1FkM1liR0dyakV6eHJlZ0NmRWxRZmhaTFBDaEttQ0orb01wM2svL2RrRUhoSXNvPQsAAwAAAA0xNzM2NzIzODI4NjY3AAAADAAJCwABAAAAVlJpL1BsYndGK3Z4Yjdjb3BFSGgzOGNVdmx2cSt1cVp2eWRybVd3T2lBWE80c09mbm94MUUvM1U1RVV6QjBGL0RjMGkzNGNEejBXNjBXdFpTWnkrZUJBCwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNAsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09AAA=",
      "message_event_signature": {
        "public_key_version": "1765382634817",
        "signature": "6IK9SZIMXBe5SFcB7vGZJd5A5Eb5MLvnwrhUFfBGv4S5GsSX3WWPGuInXVNfSla36EjXQQ/R/HhsA+2hPAEY7A",
        "signature_version": "7",
        "signing_public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEJ2c+3BYZs7ZCEY/UPCpmQxJO9v6FJjeusvmSZO/JEay8oF1+oXXlHV55kX4bK6/zFijNKvq1YRb0it0yXqbglA=="
      }
    }
  }
}

`chat.sent`

chat.sent

{
  "data": {
    "event_uuid": "3723060601307155846",
    "filter": {
      "user_id": "1830023695835787264"
    },
    "event_type": "chat.sent",
    "tag": "my chat sent",
    "payload": {
      "conversation_token": "eyJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0aW5nVXNlciI6ICIxODMwMDIzNjk1ODM1Nzg3MjY0IiwgInJlY2lwaWVudCI6ICIxMDM0MjAyMjcyMzEyNTA0MzIwIiwgInZhbGlkU2luY2VNU2VjIjogIjE3NDU4ODQ4MDAwMDAifQ.86ymJsmru5KJtNvlvNXCErgMeevqaNBgBvLiSZa_kbo",
      "id": "8e75466b-56ec-4e88-bddf-b18f7cc6030e",
      "created_at_msec": "1784841233939",
      "sender_id": "1830023695835787264",
      "conversation_id": "1034202272312504320:1830023695835787264",
      "conversation_key_version": "1768236281331",
      "encoded_event": "CwABAAAAEzIwODA0MDEwMzczMzMyMzc3NjALAAIAAAAkOGU3NTQ2NmItNTZlYy00ZTg4LWJkZGYtYjE4ZjdjYzYwMzBlCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5KbFkybHdhV1Z1ZENJNklDSXhNRE0wTWpBeU1qY3lNekV5TlRBME16SXdJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3ODQ4NDEyMzM5MzkMAAcMAAELAGQAAABTH3krC1zh+3xP3AFJAdsXAzyU+i28GsAnsxk9LHLIAkYOcRpiEaP4ajkqrZ9PgxuqhA3+nsvJYyGDPHxeH+Wop/15BXDMmwGt6S259l3odPepvEMLAGUAAAANMTc2ODIzNjI4MTMzMQIAZgECAGkACABqAAAAAQwAbAsAAQAAACB948bZ8lP62xtQFXYtMh1V2xrDLFa7kwSnsXLgwLydVAsAAgAAAEgNfFI7/1jMfU7qQ0sfzSMEnapZn+9JlopoOmO9vm7FjZwEQgtk0E6A8ZxhUCSWN8xxb6k2aK417KxvDO5C6iD7DKy3mwc6phYAAgBtAAAADAAJCwABAAAAVk1hbnVSdkJ1cGlwMzhYemdTNzMzVjl4Vm4vNis0dWd1TXd2TWErWVVEUWlESXhWaFZiYVFjTitiS3liUFJCQ2o3SVB1UmkyUVF6UnZQZzdXcTlaaFB3CwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNwsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09DwAFDAAAAAELAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAA0xNzM2NzIzODI4NjY3CwADAAAAfE1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXl4UVkrM0NJMmx3TUY1RXFSV2M2WE1SblltVG5hUVhoUXkxb3pjaHowSVFuN3VpNXJ5MVVTelNjVDkwMFd5VFBrTm1TdkcrTTh0eHorOFk1V2YwZ1pRPT0AAAIACwELAA0AAAADMC0yAA==",
      "conversation_key_change_event": "CwABAAAAEzIwMTA3NTQ4MTkxMTY0NDk5MDULAAIAAAAkNGNlNjQ1ZDItYTg5YS00OTlmLThiZGUtZTBhMWY0M2QxOTFmCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3NjgyMzYyODE1NTkMAAcMAAMLAAEAAAANMTc2ODIzNjI4MTMzMQ8AAgwAAAACCwABAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAIAAACYQkVzU1pNTTZxMEhPM0FRVjlXWk52cWh0YndyblFpeE1zcEo5VkVZNmpvMVR2cFV1SmxjaE9GNVgxMFUrUStFRmMvZWZjMlpjYnRmSFR6ZFlzSDN2VExXdENJZE1qR1orZ0JGc0o4cEF1cmx6clR6ZkFPeVNPNWlYZEhBeVJ6c085TlV0TGZnUjJ4TWxJRVA2Y2M4bk1nUT0LAAMAAAANMTc2NTM4MjYzNDgxNwALAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAJhCRDdHZEdXYklaaHdQaEFQaFYwVktoKyswR2poR3l5QXp0Yk1jL0ZHSWYvbCtSYThpU3lhV2tROFpSVVJtT25aRnN5VzNwMjRiMFp1QWg3dkNjZlpOV2dOZ1hpQUJIZmYxL1RpVFdLZ1FkM1liR0dyakV6eHJlZ0NmRWxRZmhaTFBDaEttQ0orb01wM2svL2RrRUhoSXNvPQsAAwAAAA0xNzM2NzIzODI4NjY3AAAADAAJCwABAAAAVlJpL1BsYndGK3Z4Yjdjb3BFSGgzOGNVdmx2cSt1cVp2eWRybVd3T2lBWE80c09mbm94MUUvM1U1RVV6QjBGL0RjMGkzNGNEejBXNjBXdFpTWnkrZUJBCwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNAsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09AAA=",
      "message_event_signature": {
        "public_key_version": "1736723828667",
        "signature": "ManuRvBupip38XzgS733V9xVn/6+4uguMwvMa+YUDQiDIxVhVbaQcN+bKybPRBCj7IPuRi2QQzRvPg7Wq9ZhPw",
        "signature_version": "7",
        "signing_public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEyxQY+3CI2lwMF5EqRWc6XMRnYmTnaQXhQy1ozchz0IQn7ui5ry1USzScT900WyTPkNmSvG+M8txz+8Y5Wf0gZQ=="
      }
    }
  }
}

`chat.conversation_join`

ユーザーが暗号化されたチャット会話に参加したときに発火します。ペイロードの形状は他のチャットイベント（会話の識別情報とエンコードされた暗号化マテリアル）と同じです。プライベートイベント — ユーザーコンテキスト認証が必要です。

レガシー DM イベント

レガシー（暗号化されていない）DM イベント。プライベートイベント — ユーザーコンテキスト認証が必要です。

`dm.sent`

フィルター対象のユーザーが暗号化されていない DM を送信したときに発火します。payload には direct_message_events と users マップが含まれます。

dm.sent

{
  "data": {
    "event_uuid": "-3577827201104920132",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "dm.sent",
    "tag": "my dm sent",
    "payload": {
      "direct_message_events": [
        {
          "type": "message_create",
          "id": "2080763914820927863",
          "created_timestamp": "1784927750704",
          "message_create": {
            "target": {
              "recipient_id": "2244994945"
            },
            "sender_id": "1716450569358098432",
            "message_data": {
              "text": "XAA docs payload capture test - please ignore 1784927750",
              "entities": {
                "hashtags": [],
                "symbols": [],
                "user_mentions": [],
                "urls": []
              }
            }
          }
        }
      ],
      "users": {
        "1716450569358098432": {
          "data": {
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426",
            "username": "taycaldwell",
            "affiliation": {
              "description": "X",
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "url": "https://twitter.com/X"
            },
            "name": "Taylor",
            "verified_type": "blue",
            "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers",
            "location": "Palo Alto, CA",
            "public_metrics": {
              "followers_count": 5502,
              "followers_count_str": "5502",
              "following_count": 651,
              "following_count_str": "651",
              "tweet_count": 789,
              "tweet_count_str": "789",
              "listed_count": 47,
              "listed_count_str": "47",
              "like_count": 8010,
              "like_count_str": "8010",
              "media_count": 79,
              "media_count_str": "79"
            },
            "id": "1716450569358098432",
            "url": "https://t.co/OS6XL5y4m6",
            "protected": false,
            "created_at": "2023-10-23T13:44:53.000Z",
            "is_identity_verified": true,
            "verified": true,
            "entities": {
              "url": {
                "urls": [
                  {
                    "start": 0,
                    "start_str": "0",
                    "end": 23,
                    "end_str": "23",
                    "url": "https://t.co/OS6XL5y4m6",
                    "expanded_url": "https://console.x.com",
                    "display_url": "console.x.com"
                  }
                ]
              },
              "description": {
                "mentions": [
                  {
                    "start": 29,
                    "start_str": "29",
                    "end": 36,
                    "end_str": "36",
                    "username": "google"
                  },
                  {
                    "start": 38,
                    "start_str": "38",
                    "end": 47,
                    "end_str": "47",
                    "username": "coinbase"
                  },
                  {
                    "start": 49,
                    "start_str": "49",
                    "end": 51,
                    "end_str": "51",
                    "username": "X"
                  },
                  {
                    "start": 52,
                    "start_str": "52",
                    "end": 64,
                    "end_str": "64",
                    "username": "XDevelopers"
                  }
                ]
              }
            },
            "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg"
          }
        },
        "2244994945": {
          "data": {
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1690213128",
            "username": "XDevelopers",
            "affiliation": {
              "description": "X",
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "url": "https://twitter.com/X"
            },
            "name": "Developers",
            "verified_type": "business",
            "description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API.",
            "location": "127.0.0.1",
            "public_metrics": {
              "followers_count": 694887,
              "followers_count_str": "694887",
              "following_count": 762,
              "following_count_str": "762",
              "tweet_count": 4309,
              "tweet_count_str": "4309",
              "listed_count": 2978,
              "listed_count_str": "2978",
              "like_count": 2626,
              "like_count_str": "2626",
              "media_count": 829,
              "media_count_str": "829"
            },
            "id": "2244994945",
            "url": "https://t.co/NIwHVIVyrN",
            "protected": false,
            "created_at": "2013-12-14T04:35:55.000Z",
            "is_identity_verified": false,
            "verified": true,
            "entities": {
              "url": {
                "urls": [
                  {
                    "start": 0,
                    "start_str": "0",
                    "end": 23,
                    "end_str": "23",
                    "url": "https://t.co/NIwHVIVyrN",
                    "expanded_url": "https://docs.x.com/",
                    "display_url": "docs.x.com"
                  }
                ]
              }
            },
            "profile_image_url": "https://pbs.twimg.com/profile_images/1683501992314798080/xl1POYLw_normal.jpg"
          }
        }
      }
    }
  }
}

`dm.received`

フィルター対象のユーザーが暗号化されていない DM を受信したときに発火します。ペイロードの形状は dm.sent と同じです（direct_message_events と users マップ）。プライベートイベント — ユーザーコンテキスト認証が必要です。

dm.received

{
  "data": {
    "event_uuid": "-6850472171600526495",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "dm.received",
    "tag": "my dm received",
    "payload": {
      "direct_message_events": [
        {
          "type": "message_create",
          "id": "2080765901528535096",
          "created_timestamp": "1784928224372",
          "message_create": {
            "target": {
              "recipient_id": "1716450569358098432"
            },
            "sender_id": "2046316926083764224",
            "message_data": {
              "text": "hello!",
              "entities": {
                "hashtags": [],
                "symbols": [],
                "user_mentions": [],
                "urls": []
              }
            }
          }
        }
      ],
      "users": {
        "2046316926083764224": {
          "data": {
            "description": "",
            "profile_banner_url": "",
            "public_metrics": {
              "followers_count": 97,
              "followers_count_str": "97",
              "following_count": 1,
              "following_count_str": "1",
              "tweet_count": 50,
              "tweet_count_str": "50",
              "listed_count": 4,
              "listed_count_str": "4",
              "like_count": 27,
              "like_count_str": "27",
              "media_count": 3,
              "media_count_str": "3"
            },
            "protected": false,
            "url": "",
            "affiliation": {
              "description": "Automated",
              "badge_url": "https://pbs.twimg.com/semantic_core_img/1428827730364096519/4ZXpTBhS?format=png&name=orig"
            },
            "is_identity_verified": false,
            "id": "2046316926083764224",
            "profile_image_url": "https://pbs.twimg.com/profile_images/2050311008334598144/EX0NG310_normal.jpg",
            "verified_type": "none",
            "created_at": "2026-04-20T19:55:59.000Z",
            "username": "paypertaylor2",
            "verified": false,
            "name": "paypertaylor2"
          }
        },
        "1716450569358098432": {
          "data": {
            "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers",
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028",
            "entities": {
              "url": {
                "urls": [
                  {
                    "start": 0,
                    "start_str": "0",
                    "end": 23,
                    "end_str": "23",
                    "url": "https://t.co/7SzJl0jTOo",
                    "expanded_url": "https://developer.x.com",
                    "display_url": "developer.x.com"
                  }
                ]
              },
              "description": {
                "mentions": [
                  {
                    "start": 28,
                    "start_str": "28",
                    "end": 35,
                    "end_str": "35",
                    "username": "google"
                  },
                  {
                    "start": 37,
                    "start_str": "37",
                    "end": 46,
                    "end_str": "46",
                    "username": "coinbase"
                  },
                  {
                    "start": 48,
                    "start_str": "48",
                    "end": 50,
                    "end_str": "50",
                    "username": "X"
                  },
                  {
                    "start": 51,
                    "start_str": "51",
                    "end": 63,
                    "end_str": "63",
                    "username": "XDevelopers"
                  }
                ]
              }
            },
            "public_metrics": {
              "followers_count": 5502,
              "followers_count_str": "5502",
              "following_count": 651,
              "following_count_str": "651",
              "tweet_count": 789,
              "tweet_count_str": "789",
              "listed_count": 46,
              "listed_count_str": "46",
              "like_count": 8010,
              "like_count_str": "8010",
              "media_count": 79,
              "media_count_str": "79"
            },
            "location": "San Francisco, CA",
            "protected": false,
            "url": "https://t.co/7SzJl0jTOo",
            "affiliation": {
              "description": "X",
              "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
              "url": "https://twitter.com/X"
            },
            "is_identity_verified": true,
            "id": "1716450569358098432",
            "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg",
            "verified_type": "blue",
            "created_at": "2023-10-23T13:44:53.000Z",
            "username": "taycaldwell",
            "verified": true,
            "name": "Taylor Caldwell"
          }
        }
      }
    }
  }
}

`dm.read`

参加者がフィルター対象ユーザーの暗号化されていない DM を読んだとき（既読受信）に発火します。プライベートイベント — ユーザーコンテキスト認証が必要です。

`dm.indicate_typing`

参加者がフィルター対象のユーザーへメッセージを入力しているときに発火します。プライベートイベント — ユーザーコンテキスト認証が必要です。

News イベント

`news.new`

keyword でフィルタリングします。payload には Grok がキュレートしたニュースフィールド（カテゴリー、名称、フック、要約、コンテキスト、関連クラスタ Post 結果など）が含まれます。

フィールド	説明
`id`	ニュース項目の ID
`name`	見出し / トピック名
`category`	ニュースのカテゴリー
`hook`	短いフック / ティーザー
`summary`	より長い要約
`contexts`	関連するトピック / エンティティのコンテキスト
`cluster_posts_results`	関連する Post（利用可能な場合）
`updated_at`	最終更新タイムスタンプ
`disclaimer`	任意の免責事項テキスト

news.new

{
  "data": {
    "event_uuid": "2080756868147019827",
    "filter": {
      "keyword": "OpenAI"
    },
    "event_type": "news.new",
    "tag": "openai news",
    "payload": {
      "summary": "OpenAI rolled out a new feature in ChatGPT's web version that lets users create virtual pets by describing them, generating fun companions like a fluffy gray cat or a seal in a yellow bow tie. Creators can copy a shareable link from personalization settings, allowing friends to adopt the pet easily, with spritesheets downloadable for the desktop app. Reactions lean lighthearted, with users calling the pets underrated and dreaming up Pokémon-style trading and battles, though some wonder about better uses for the tech.",
      "contexts": {
        "entities": {
          "events": [],
          "organizations": [
            "OpenAI"
          ],
          "people": [],
          "places": [],
          "products": []
        },
        "topics": [
          "Technology"
        ],
        "finance": {
          "tickers": []
        },
        "sports": {
          "teams": []
        }
      },
      "id": "2080756868147019827",
      "updated_at": "2026-07-24T20:53:37.000Z",
      "hook": "Imagine designing a green dinosaur with a bow tie, then sharing it with friends to adopt as their own ChatGPT companion.",
      "category": "News",
      "disclaimer": "This story is a summary of posts on X and may evolve over time. Grok can make mistakes, verify its outputs.",
      "cluster_posts_results": [
        {
          "post_id": "2080756403493560652"
        },
        {
          "post_id": "2080747505474736162"
        },
        {
          "post_id": "2080750142437880021"
        },
        {
          "post_id": "2080748929197523160"
        },
        {
          "post_id": "2080747522323308860"
        },
        {
          "post_id": "2080755240777736204"
        },
        {
          "post_id": "2080749609681641909"
        },
        {
          "post_id": "2080752936594903495"
        },
        {
          "post_id": "2080752950692172087"
        },
        {
          "post_id": "2080755140794237414"
        }
      ],
      "name": "ChatGPT Adds Custom Virtual Pets for Sharing"
    }
  }
}

Spaces イベント

`spaces.start`

フィルター対象のユーザーが Space を開始したときに発火します。payload にはホストの user、broadcast_id、および内部の event_type start が含まれます。

spaces.start

{
  "data": {
    "event_uuid": "4093201169289922041",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "spaces.start",
    "tag": "my spaces start",
    "payload": {
      "user": {
        "data": {
          "affiliation": {
            "description": "X",
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "url": "https://twitter.com/X"
          },
          "location": "San Francisco, CA",
          "name": "Taylor Caldwell",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg",
          "created_at": "2023-10-23T13:44:53.000Z",
          "protected": false,
          "verified": true,
          "url": "https://t.co/7SzJl0jTOo",
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 651,
            "following_count_str": "651",
            "tweet_count": 789,
            "tweet_count_str": "789",
            "listed_count": 46,
            "listed_count_str": "46",
            "like_count": 8010,
            "like_count_str": "8010",
            "media_count": 79,
            "media_count_str": "79"
          },
          "is_identity_verified": true,
          "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers",
          "verified_type": "blue",
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/7SzJl0jTOo",
                  "expanded_url": "https://developer.x.com",
                  "display_url": "developer.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 28,
                  "start_str": "28",
                  "end": 35,
                  "end_str": "35",
                  "username": "google"
                },
                {
                  "start": 37,
                  "start_str": "37",
                  "end": 46,
                  "end_str": "46",
                  "username": "coinbase"
                },
                {
                  "start": 48,
                  "start_str": "48",
                  "end": 50,
                  "end_str": "50",
                  "username": "X"
                },
                {
                  "start": 51,
                  "start_str": "51",
                  "end": 63,
                  "end_str": "63",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028",
          "username": "taycaldwell",
          "id": "1716450569358098432"
        }
      },
      "broadcast_id": "1qxvvvyLLdnxB",
      "event_type": "spaces_start"
    }
  }
}

`spaces.end`

フィルター対象のユーザーが Space を終了したときに発火します。形状は spaces.start と同じで、内部の event_type は end になります。

spaces.end

{
  "data": {
    "event_uuid": "-498317022904955631",
    "filter": {
      "user_id": "1716450569358098432"
    },
    "event_type": "spaces.end",
    "tag": "my spaces end",
    "payload": {
      "user": {
        "data": {
          "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers",
          "protected": false,
          "is_identity_verified": true,
          "affiliation": {
            "url": "https://twitter.com/X",
            "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
            "description": "X"
          },
          "entities": {
            "url": {
              "urls": [
                {
                  "start": 0,
                  "start_str": "0",
                  "end": 23,
                  "end_str": "23",
                  "url": "https://t.co/7SzJl0jTOo",
                  "expanded_url": "https://developer.x.com",
                  "display_url": "developer.x.com"
                }
              ]
            },
            "description": {
              "mentions": [
                {
                  "start": 28,
                  "start_str": "28",
                  "end": 35,
                  "end_str": "35",
                  "username": "google"
                },
                {
                  "start": 37,
                  "start_str": "37",
                  "end": 46,
                  "end_str": "46",
                  "username": "coinbase"
                },
                {
                  "start": 48,
                  "start_str": "48",
                  "end": 50,
                  "end_str": "50",
                  "username": "X"
                },
                {
                  "start": 51,
                  "start_str": "51",
                  "end": 63,
                  "end_str": "63",
                  "username": "XDevelopers"
                }
              ]
            }
          },
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028",
          "public_metrics": {
            "followers_count": 5502,
            "followers_count_str": "5502",
            "following_count": 651,
            "following_count_str": "651",
            "tweet_count": 789,
            "tweet_count_str": "789",
            "listed_count": 46,
            "listed_count_str": "46",
            "like_count": 8010,
            "like_count_str": "8010",
            "media_count": 79,
            "media_count_str": "79"
          },
          "id": "1716450569358098432",
          "verified_type": "blue",
          "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg",
          "name": "Taylor Caldwell",
          "url": "https://t.co/7SzJl0jTOo",
          "username": "taycaldwell",
          "location": "San Francisco, CA",
          "verified": true,
          "created_at": "2023-10-23T13:44:53.000Z"
        }
      },
      "broadcast_id": "1qxvvvyLLdnxB",
      "event_type": "spaces_end"
    }
  }
}

Mute イベント

Mute イベントは、follow イベントと同様に source / target のユーザーペアを使用します。プライベートイベント — mute.read スコープを持つユーザーコンテキスト認証が必要です。user_id フィルターは、ミュートまたはミュート解除を実行するユーザー（ミュート対象のアカウントではない）とマッチします。

`mute.mute`

フィルター対象のユーザーが他のユーザーをミュートしたときに発火します。

`mute.unmute`

フィルター対象のユーザーが他のユーザーのミュートを解除したときに発火します。

Block イベント

Block イベントは、follow イベントと同様に source / target のユーザーペアを使用します。プライベートイベント — block.read スコープを持つユーザーコンテキスト認証が必要です。user_id フィルターは、ブロックまたはブロック解除を実行するユーザー（ブロック対象のアカウントではない）とマッチします。

`block.block`

フィルター対象のユーザーが他のユーザーをブロックしたときに発火します。

`block.unblock`

フィルター対象のユーザーが他のユーザーのブロックを解除したときに発火します。

OAuth イベント

`oauth.revoke`

ユーザーがアプリケーションへのアクセスを取り消したときに発火します。filter は空になる場合があります。これを利用して、取り消したユーザーのローカル状態をクリーンアップしてください。

oauth.revoke

{
  "data": {
    "event_uuid": "5934540941047412905",
    "filter": {},
    "event_type": "oauth.revoke",
    "payload": {
      "date_time": "2026-07-23T21:44:05+00:00",
      "user_id": "1830023695835787264",
      "app_id": "29820954"
    }
  }
}

次のステップ

はじめに

サポートされているイベントタイプ、プライバシー、認証

クイックスタート

サブスクリプションを作成してイベントを受信する

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

永続 HTTP ストリームに接続する

Webhook

アクティビティイベントを webhook URL に配信する

​Post イベント

​post.create

​post.delete

​post.mention.create

​Like イベント

​like.create

​Follow イベント

​follow.follow

​follow.unfollow

​Profile イベント

​profile.update.bio

​profile.update.profile_picture

​profile.update.banner_picture

​profile.update.screenname

​profile.update.geo

​profile.update.url

​profile.update.handle

​profile.update.verified_badge

​profile.update.affiliate_badge

​Chat イベント（XChat）

​chat.received

​chat.sent

​chat.conversation_join

​レガシー DM イベント

​dm.sent

​dm.received

​dm.read

​dm.indicate_typing

​News イベント

​news.new

​Spaces イベント

​spaces.start

​spaces.end

​Mute イベント

​mute.mute

​mute.unmute

​Block イベント

​block.block

​block.unblock

​OAuth イベント

​oauth.revoke

​次のステップ