Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Follows

Relevant followers

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

get/v2/farcaster/followers/relevant/

Query parameters

target_fidinteger required

User who's profile you are looking at

viewer_fidinteger required

The FID of the user to customize this response for. Providing this will also return a list of followers that respects this user's mutes and blocks and includes viewer_context.

Headers

x-neynar-experimentalboolean

Enables experimental features including filtering based on the Neynar score. See docs for more details.

Response

Success

Example response

{
  "all_relevant_followers_dehydrated": [
    {
      "user": {
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "fid": 3
      }
    }
  ],
  "top_relevant_followers_hydrated": [
    {
      "app": {
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "fid": 3
      },
      "user": {
        "auth_addresses": [
          {
            "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
            "app": {
              "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
              "fid": 3
            }
          }
        ],
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "fid": 3,
        "profile": {
          "bio": {
            "mentioned_profiles": [
              {
                "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
                "fid": 3
              }
            ]
          }
        },
        "verifications": [
          "0x5a927ac639636e534b678e81768ca19e2c6280b7"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          ],
          "primary": {
            "eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          }
        }
      }
    }
  ]
}