v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Follows

Following

Fetch a list of users who a given user is following. Can optionally include a viewer_fid and sort_type.

get/v2/farcaster/following/

Query parameters

fidinteger required

FID of the user whose following you want to fetch.

viewer_fidinteger

Example:3

Providing this will return a list of users that respects this user's mutes and blocks and includes viewer_context.

sort_type'desc_chron' | 'algorithmic'

Example:desc_chron

Optional parameter to sort the users based on different criteria.

limitinteger

Number of results to fetch

cursorstring

Pagination cursor.

Headers

x-neynar-experimentalboolean

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

Response

Success

Example response

{
  "users": [
    {
      "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"
          }
        }
      }
    }
  ]
}