The Account Activity API provides you the ability to subscribe to realtime activities related to a user account via webhooks. This means that you can receive realtime Tweets, Direct Messages, and other account events from one or more of your owned or subscribed accounts through a single connection.

You will receive all related activities below for each user subscription on your webhook registration:

Activity types
  • Tweets (by user)
  • Tweet deletes (by user)
  • @mentions (of user)
  • Replies (to or from user)
  • Retweets (by user or of user)
  • Quote Tweets (by user or of user)
  • Retweets of Quoted Tweets (by user or of user)
  • Likes (by user or of user)
  • Follows (by user or of user)
  • Unfollows (by user)
  • Blocks (by user)
  • Unblocks (by user)
  • Mutes (by user)
  • Unmutes (by user)
  • Direct Messages sent (by user)
  • Direct Messages received (by user)
  • Typing indicators (to user)
  • Read receipts (to user)
  • Subscription revokes (by user)

Please note - We do not deliver home timeline data via the Account Activity API. Please use the GET statuses/home_timeline to pull this data.

Video Series

Check out our four-part video series on the Account Activity API to get up to speed!


Feature summary

Tier Pricing Number of unique subscriptions Number of webhooks Reliability and Activity Recovery
Premium Free (Sandbox) Up to 15 1 No retries
Premium Paid Up to 25, 50,100, 250 2 Retries
Enterprise Contact sales Up to 500+ 3+ Retries and Replay


Next steps