get_followers

Get the list of users following a specific user.

Authentication

Optional: Public tool (works without authentication)

Parameters

actor (required)

• Type: string
• Description: User identifier (DID or handle)

limit (optional)

• Type: number
• Default: 50
• Constraints: 1-100
• Description: Maximum number of followers to return

cursor (optional)

• Type: string
• Description: Pagination cursor from previous response

Response

{
  success: boolean;
  followers: Array<{
    did: string;
    handle: string;
    displayName?: string;
    description?: string;
    avatar?: string;
    indexedAt?: string;
    viewer?: {
      muted?: boolean;
      blockedBy?: boolean;
      following?: string;
      followedBy?: string;
    };
  }>;
  subject: {
    did: string;
    handle: string;
    displayName?: string;
    avatar?: string;
  };
  cursor?: string;
  hasMore: boolean;
}

Examples

Get Followers by Handle

{
  "actor": "alice.bsky.social",
  "limit": 50
}

Get Followers with Pagination

{
  "actor": "alice.bsky.social",
  "limit": 50,
  "cursor": "cursor_from_previous_response"
}

Error Handling

Common Errors

Invalid Actor

{
  "error": "Actor (DID or handle) is required",
  "code": "VALIDATION_ERROR"
}

User Not Found

{
  "error": "User not found",
  "code": "NOT_FOUND"
}

Best Practices

• Use pagination for users with many followers
• Cache follower lists for short periods
• Respect privacy settings

Related Tools

• get_follows - Get users a user follows
• get_user_profile - Get user profile
• follow_user - Follow a user

See Also

• Social Operations Examples