---
title: "Relevant followers"
method: GET
path: "/v2/farcaster/followers/relevant/"
tags: ["Follows"]
---

# Relevant followers

`GET /v2/farcaster/followers/relevant/`

Returns a list of relevant followers for a specific FID. This usually shows on a profile as "X, Y and Z follow this user".

## Query parameters

- `target_fid` integer, required
- `viewer_fid` integer, required

## Headers

- `x-neynar-experimental` boolean

## Response `200`

Success

- RelevantFollowersResponse
  - `all_relevant_followers_dehydrated` FollowerDehydrated[], required
    - `object` 'follower_dehydrated', required
    - `user` UserDehydrated, required
      - `custody_address` string — Ethereum address
      - `display_name` string, nullable
      - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
      - `object` 'user_dehydrated', required
      - `pfp_url` string, nullable
      - `score` number
      - `username` string
  - `top_relevant_followers_hydrated` Follower[], required
    - `app` UserDehydrated
      - `custody_address` string — Ethereum address
      - `display_name` string, nullable
      - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
      - `object` 'user_dehydrated', required
      - `pfp_url` string, nullable
      - `score` number
      - `username` string
    - `object` 'follower', required
    - `user` User, required
      - `auth_addresses` object[], required
        - `address` string, required — Ethereum address
        - `app` UserDehydrated, required
          - `custody_address` string — Ethereum address
          - `display_name` string, nullable
          - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
          - `object` 'user_dehydrated', required
          - `pfp_url` string, nullable
          - `score` number
          - `username` string
      - `custody_address` string, required — Ethereum address
      - `display_name` string, nullable
      - `experimental` object
        - `deprecation_notice` string
        - `neynar_user_score` number, double, required — Score that represents the probability that the account is not spam.
      - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
      - `follower_count` integer, required — The number of followers the user has.
      - `following_count` integer, required — The number of users the user is following.
      - `object` 'user', required
      - `pfp_url` string, nullable — The URL of the user's profile picture
      - `pro` object
        - `expires_at` string, date-time, required
        - `status` 'subscribed' | 'unsubscribed', required — The subscription status of the user
        - `subscribed_at` string, date-time, required
      - `profile` object, required
        - `banner` object
          - `url` string, uri — The URL of the user's banner image
        - `bio` object, required
          - `mentioned_channels` ChannelDehydrated[]
            - `id` string, required
            - `image_url` string
            - `name` string, required
            - `object` 'channel_dehydrated', required
            - `viewer_context` ChannelUserContext — Adds context on the viewer's or author's role in the channel.
              - …
          - `mentioned_channels_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
            - `end` number, required
            - `start` number, required
          - `mentioned_profiles` UserDehydrated[]
            - `custody_address` string — Ethereum address
            - `display_name` string, nullable
            - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
            - `object` 'user_dehydrated', required
            - `pfp_url` string, nullable
            - `score` number
            - `username` string
          - `mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
            - `end` number, required
            - `start` number, required
          - `text` string, required
        - `live_at` object
          - `is_live` boolean, required
          - `updated_at` string, date-time, required
          - `url` string, required — The URL of the user's current live activity
        - `location` Location — Coordinates and place names for a location
          - `address` LocationAddress
            - `city` string, required
            - `country` string, required
            - `country_code` string
            - `state` string
            - `state_code` string
          - `latitude` number, double, required
          - `longitude` number, double, required
          - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
      - `registered_at` string, date-time, required
      - `score` number, double — Score that represents the probability that the account is not spam.
      - `username` string, required
      - `verifications` EthAddress[], required
      - `verified_accounts` object[], required
        - `platform` 'x' | 'github'
        - `username` string
      - `verified_addresses` object, required
        - `eth_addresses` EthAddress[], required — List of verified Ethereum addresses of the user sorted by oldest to most recent.
        - `primary` object, required
          - `eth_address` string, required — Ethereum address
          - `sol_address` string, required — Solana address
        - `sol_addresses` SolAddress[], required — List of verified Solana addresses of the user sorted by oldest to most recent.
      - `viewer_context` UserViewerContext — Adds context on the viewer's follow relationship with the user.
        - `blocked_by` boolean, required — Indicates if the viewer is blocked by the user.
        - `blocking` boolean, required — Indicates if the viewer is blocking the user.
        - `followed_by` boolean, required — Indicates if the viewer is followed by the user.
        - `following` boolean, required — Indicates if the viewer is following the user.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)