Follow Updates

This feature tracks real-time follow and unfollow events between Twitter users.

How to Enable the Twitter Follow/Unfollow Tracker

To start tracking follow and unfollow activity for specific Twitter accounts:

1. Go to: Settings > Twitter

2. Find the account you want to monitor.

3. Enable the "Follows" toggle for that account. This will activate real-time tracking of all their follow/unfollow actions.

Object Structure

{
  "body": String,
  "receivedAt": String,
  "createdAt": String,
  "source": String,
  "username": String,
  "name": String,
  "url": String,
  "icon": String,
  "isFollowUpdate": Boolean,
  "twitterId": String,
  "tweetId": String,
  "twitterFollowed": Object,          // Present if follow event
  "twitterUnfollowed": Object,        // Present if unfollow event
  "_id": String,
}

Field Descriptions

Field	Type	Description
body	String	Summary of the event. Includes the action and usernames.
receivedAt	String	Timestamp when the event was received by the system.
source	String	Always "Twitter" for these events.
username	String	Twitter username (without @) of the user who performed the action.
name	String	Display name of the acting user.
url	String	URL to the acting user's Twitter profile.
icon	String	Profile picture of the acting user.
isFollowUpdate	Boolean	Always true. Indicates this message refers to a follow/unfollow event.
twitterId	String	Twitter ID of the user who performed the action.
tweetId	String	Internal ID associated with the event. Not a real Tweet ID.
twitterFollowed	Object	Full profile metadata of the followed user. Present only on follow events.
twitterUnfollowed	Object	Full profile metadata of the unfollowed user. Present only on unfollow events.
_id	String	Unique internal ID for the event.

Sub-object: twitterFollowed or twitterUnfollowed

These objects contain metadata about the user that was followed or unfollowed:

{
  "bio": String,
  "profileImage": String,
  "banner": String,
  "followers": Number,
  "following": Number,
  "postsCount": Number,
  "location": String,
  "profileUrl": String,
  "profileCreatedAt": String,
  "username": String,
  "name": String,
  "twitterId": String,
  "url": String
}

Field Descriptions

Field	Type	Description
bio	String	Bio of the user.
profileImage	String	Twitter profile image URL.
banner	String	Twitter banner image URL.
followers	Number	Follower count of the user.
following	Number	Number of accounts the user follows.
postsCount	Number	Number of posts/tweets.
location	String	Location in the user’s Twitter profile
profileUrl	String	Website or external link listed in the user’s Twitter profile
profileCreatedAt	String	Account creation date.
username	String	Twitter handle (without @).
name	String	Display name.
twitterId	String	Unique Twitter ID of the user.
url	String	URL to their Twitter profile.