1

Announcing the new X Activity API (XAA)

We are excited to announce a public beta of the X Activity API (XAA) - a new suite of endpoints for developers designed to deliver real-time signals from X.

A developer can subscribe to events they are interested in such as ProfileBioUpdate, ProfilePictureUpdate etc. and filter for the User ID whose events they want. The matching events for that User ID will be delivered to your app with sub-second latency.

Supported Event Types

Currently, X Activity API supports the following profile update events:

  • BioUpdate: Fired when a user updates their profile bio
  • ProfilePictureUpdate: Fired when a user updates their profile picture
  • ProfileBannerUpdate: Fired when a user updates their profile banner
  • ProfileGeoUpdate: Fired when a user updates their profile location
  • ProfileUrlUpdate: Fired when a user updates their profile website URL

Below is an example JSON response for a `ProfileBioUpdate` event.

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

Getting started

In order to get User events, there generally 3 steps involved:

  1. Identify the User ID for the User who’s events you want to filter on
  2. Create a subscription for the type of event you want to filter for that User
  3. Receive the events using webhooks or persistent http stream connection

Check out our Quick Start guide for detailed steps on using these endpoints.

While the X Activity API is in open beta, please expect potential bugs, breaking changes, or incomplete features.

Please reach out to us if you have any questions or feedback.

X Developer Platform Team

3 Likes