profile.update.bio, post.create, post.delete 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.
Delivery mechanisms
The X Activity API currently supports the following delivery mechanisms to send events to your app:- Persistent HTTP stream
- Webhook
Supported event types
Currently, X Activity API supports the following event types, organized by category:Profile Events
Profile events are triggered when a user makes changes to their profile information.Follow Events
Follow events are triggered when the filtered user follows another user, or is followed by another user.Enterprise Only: The
follow.follow and follow.unfollow events are only available to Enterprise and Partner tier accounts at this time.Spaces Events
Spaces events are triggered when a user starts or ends a Space.Post Events
Post events are triggered when a user creates or deletes a Post.Post events via XAA vs Filtered Stream: X Activity API supports
post.create and post.delete events. Subscribe by user_id to get real-time notifications when users create or delete Posts.If you want targeted keyword filtering, boolean logic, geo targeting, language filters, or any of the other operators that the Filtered Stream supports, use the Filtered Stream endpoint instead.Legacy DM Events
Legacy DM events pertain to the legacy, unencrypted DM system.Chat Events
Chat events pertain to the new, encrypted messaging stack, or XChat.News Events
News events provide updates on trending topics and headlines curated by Grok.Enterprise Only: The
news.new event is only available to Enterprise and Partner tier accounts at this time.Event privacy and authentication
The X Activity API distinguishes between public events and private events as at parity with the X app as explained below.Public Events
Public events are activities that a public user account performs publicly that are visible to all X users. These events are visible to all users on the X platform and don’t require OAuth authentication from the user in order to view. Current public events:- Profile updates (bio, picture, banner, location, URL, username changes)
- Post creation (
post.create) and deletion (post.delete)
Private Events
Private events are activities that require explicit user consent through OAuth authentication. A User has to authenticate via X and give explicit permission to a developer app to access these events. Authentication requirements for private events:- The user must authenticate your application via OAuth 2.0
- Your application must obtain appropriate OAuth scopes
- The user must explicitly grant permission for your app to access these events
- Subscriptions for private events can only be created for users who have authorized your application
Subscription limits
The X Activity API has different subscription limits based on your account tier:Endpoints
Account setupTo access these endpoints, you will need:
- An approved developer account.
- To authenticate using the keys and tokens from a developer App that is located within a Project.