> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch followers by user ID

> Fetch the followers of any user by their ID

## Overview

Returns a function that fetches the paginated list of followers for any user, identified by `userId`. This is a public endpoint — authentication is not required.

For fetching your own followers, see `useFetchFollowers`.

## Usage Example

```tsx theme={null}
import { useFetchFollowersByUserId } from "@replyke/react-js";

function UserFollowers({ userId }: { userId: string }) {
  const fetchFollowersByUserId = useFetchFollowersByUserId();
  const [followers, setFollowers] = useState([]);

  useEffect(() => {
    fetchFollowersByUserId({ userId, page: 1 }).then((res) => {
      setFollowers(res.data);
    });
  }, [userId]);

  return (
    <ul>
      {followers.map(({ followId, user }) => (
        <li key={followId}>{user.name}</li>
      ))}
    </ul>
  );
}
```

## Parameters

The hook returns a function. That function accepts:

<ParamField path="userId" type="string" required>
  The ID of the user whose followers to fetch.
</ParamField>

<ParamField path="page" type="number">
  Page number to fetch. Defaults to `1`.
</ParamField>

<ParamField path="limit" type="number">
  Number of results per page. Defaults to `20`.
</ParamField>

## Returns

Returns a `PaginatedResponse` containing an array of follower entries:

<ResponseField name="data" type="FollowerWithFollowInfo[]">
  Array of follower entries.

  <Expandable title="FollowerWithFollowInfo properties">
    <ResponseField name="followId" type="string">
      ID of the follow record.
    </ResponseField>

    <ResponseField name="user" type="User">
      The follower's user profile. See [User data model](/data-models/user).
    </ResponseField>

    <ResponseField name="followedAt" type="string">
      ISO timestamp of when the follow was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata including `currentPage`, `totalPages`, `totalCount`, `hasNextPage`, and `hasPreviousPage`.
</ResponseField>

## Related

* [useFetchFollowers](/hooks/follows/use-fetch-followers) — fetch the current user's own followers
* [useFetchFollowersCountByUserId](/hooks/follows/use-fetch-followers-count-by-user-id) — get follower count for a user