Smart Followers List

Retrieves a list of all "smart" followers for a Twitter account. The response includes both basic profile data, such as quantitative metrics and visual details, and analytical insights, including the count of "smart" subscriptions and mentions associated with each follower. Each follower is also categorized with specific tags and assigned a tier (1 to 3), determined manually by moderators. The list supports pagination and sorting for efficient data retrieval.

Input:

Username: The username of the account on x.com.

Parameters:

Limit, Offset: Parameters for pagination.
- Limit: Maximum number of items to return in a single request.
- CREATED_AT: Number of items to skip before starting to return results.
orderBy: Determines the sorting criteria for "smart" followers. Supported values:
- CREATED_AT: Sort by the date the follower was added.
- SCORE: Sort by the follower's score on discover.getmoni.io.
- FOLLOWERS_COUNT: Sort by the total number of followers.
- SMART_FOLLOWERS_COUNT: Sort by the number of "smart" followers.
orderByDirection: Sorting direction for orderBy. Supported values:
- DESC: Descending order.
- ASC: Ascending order.
Categories: Filters "smart" followers by the specified categories. Categories should be provided as a comma-separated list. A full list of available categories can be retrieved via /api/v1/twitters/{username}/smart_followers/categories/.

Result:

{
"items": [
{
"followedAt": "2024-12-03T07:56:59.753Z", // Date and time the follower was added
"twitterUserId": 0, // Internal ID of the account on [x.com](http://x.com/)
"username": "string", // Username of the account on [x.com](http://x.com/)
"name": "string", // Name of the account on [x.com](http://x.com/)
"description": "string", // Description of the account on [x.com](http://x.com/)
"profileImageUrl": "string", // URL of the account's profile picture on [x.com](http://x.com/)
"profileBannerUrl": "string", // URL of the account's banner image on [x.com](http://x.com/)
"twitterCreatedAt": "2024-12-03T07:56:59.753Z", // Account creation date and time on [x.com](http://x.com/)
"twitterUrl": "string", // URL to the account on [x.com](http://x.com/)
"tweetCount": 0, // Total number of tweets by the account on [x.com](http://x.com/)
"followersCount": 0, // Total number of followers for the account on [x.com](http://x.com/)
"score": 0, // Score of the account based on its "smart" followers
"mentionsCount": 0, // Total number of mentions of the account on [x.com](http://x.com/)
"smartMentionsCount": 0, // Total number of mentions from "smart" accounts on [x.com](http://x.com/)
"tags": [
{
"name": "string" // Name of the tag assigned to the account
}
], // List of tags manually assigned by moderators
"smartFollowersCount": 0, // Number of "smart" followers of the account on [x.com](http://x.com/)
"level": {
"logoUrl": "string" // URL of the image representing the account's level
} // Level of the "smart" follower
}
],
"totalCount": 0 // Total number of "smart" followers for the account
}