Retrieve followers for a given channel

farcasterChannel.getFollowersByChannel

Overview

Returns a list of followers for a specific channel. Max limit is 1000. Use cursor for pagination.

Parameters

name	type	required	Note
id	string	true	ex) "lum0x"
limit	number	false	default: 25, max: 1000
cursor	string	false	ex) eyJwYWdlIjoyfQ==

Usage

Typescript

let res = await Lum0x.farcasterChannel.getFollowersByChannel({
    id: "base",
    limit: 15
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "users": [
    {
      "object": "user",
      "fid": 2,
      "custody_address": "0x4114e33eb831858649ea3702e1c9a2db3f626446",
      "username": "v",
      "display_name": "Varun Srinivasan",
      "pfp_url": "https://i.seadn.io/gae/sYAr036bd0bRpj7OX6B-F-MqLGznVkK3--DSneL_BT5GX4NZJ3Zu91PgjpD9-xuVJtHq0qirJfPZeMKrahz8Us2Tj_X8qdNPYC-imqs?w=500&auto=format",
      "profile": {
        "bio": {
          "text": "Technowatermelon. Elder Millenial. Building Farcaster. \n\nnf.td/varun"
        }
      },
      "follower_count": 400163,
      "following_count": 1297,
      "verifications": [
        "0x91031dcfdea024b4d51e775486111d2b2a715871",
        "0x182327170fc284caaa5b1bc3e3878233f529d741",
        "0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x91031dcfdea024b4d51e775486111d2b2a715871",
          "0x182327170fc284caaa5b1bc3e3878233f529d741",
          "0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0"
        ],
        "sol_addresses": [
          "9t92xZy9q5SyfKBH4rZwEDFXjaZKgzj5PgviPhKtBjyy"
        ]
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 3,
      "custody_address": "0x6b0bda3f2ffed5efc83fa8c024acff1dd45793f1",
      "username": "dwr.eth",
      "display_name": "Dan Romero",
      "pfp_url": "https://res.cloudinary.com/merkle-manufactory/image/fetch/c_fill,f_png,w_256/https://lh3.googleusercontent.com/MyUBL0xHzMeBu7DXQAqv0bM9y6s4i4qjnhcXz5fxZKS3gwWgtamxxmxzCJX7m2cuYeGalyseCA2Y6OBKDMR06TWg2uwknnhdkDA1AA",
      "profile": {
        "bio": {
          "text": "Working on Farcaster and Warpcast."
        }
      },
      "follower_count": 475914,
      "following_count": 3380,
      "verifications": [
        "0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 24,
      "custody_address": "0x5c2dc0bbd218a34dfd472b52004cb3776f311df2",
      "username": "jesse",
      "display_name": "Jesse Walden",
      "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/fa920810-fa1b-4f36-7daf-c53f837e2900/rectcrop3",
      "profile": {
        "bio": {
          "text": "@variant"
        }
      },
      "follower_count": 51196,
      "following_count": 245,
      "verifications": [
        "0xe7925d190aea9279400cd9a005e33ceb9389cc2b"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xe7925d190aea9279400cd9a005e33ceb9389cc2b"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 99,
      "custody_address": "0x4ce34af3378a00c640125e4dbf4c9e64dff4c93b",
      "username": "jessepollak",
      "display_name": "jesse.base.eth 🔵",
      "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1013b0f6-1bf4-4f4e-15fb-34be06fede00/original",
      "profile": {
        "bio": {
          "text": "@base builder #001; onchain cities w/ OAK & city3"
        }
      },
      "follower_count": 438814,
      "following_count": 1429,
      "verifications": [
        "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
        "0xe73f9c181b571cac2bf3173634d04a9921b7ffcf",
        "0x6e0d9c6dd8a08509bb625caa35dc61a991406f62",
        "0x2211d1d0020daea8039e46cf1367962070d77da9",
        "0x8e86e5331d3a020909c9e42ea9051675555f5e49",
        "0x6adea326faea1b688af33df59e18f7a819bcaa4f"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x849151d7d0bf1f34b70d5cad5149d28cc2308bf1",
          "0xe73f9c181b571cac2bf3173634d04a9921b7ffcf",
          "0x6e0d9c6dd8a08509bb625caa35dc61a991406f62",
          "0x2211d1d0020daea8039e46cf1367962070d77da9",
          "0x8e86e5331d3a020909c9e42ea9051675555f5e49",
          "0x6adea326faea1b688af33df59e18f7a819bcaa4f"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 108,
      "custody_address": "0x8e364e821f05e63f446e08f8ea2490b27c18854c",
      "username": "nick",
      "display_name": "Nick Tomaino🎩",
      "pfp_url": "https://i.imgur.com/MhG3Wji.jpg",
      "profile": {
        "bio": {
          "text": "SKIN IN THE GAME OR STFU"
        }
      },
      "follower_count": 91871,
      "following_count": 437,
      "verifications": [
        "0xeefec5734f649fd1a356894319d3d7393b6b0f8b"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xeefec5734f649fd1a356894319d3d7393b6b0f8b"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 160,
      "custody_address": "0x64c3ba87b484fbe79a7161690b15d11a27d34c2a",
      "username": "jack",
      "display_name": "jack",
      "pfp_url": "https://i.imgur.com/vwOEkfI.png",
      "profile": {
        "bio": {
          "text": "/vv /checks /opepen"
        }
      },
      "follower_count": 126848,
      "following_count": 391,
      "verifications": [
        "0x1d4c8282a408d8fe92496cccd1eaa4ff0fdd3b97"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x1d4c8282a408d8fe92496cccd1eaa4ff0fdd3b97"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 169,
      "custody_address": "0x6e6dc9975c7b820c235649924b4ab20068100e76",
      "username": "fredwilson.eth",
      "display_name": "fredwilson",
      "pfp_url": "https://lh3.googleusercontent.com/fWnQF5IzaerIcPn5rPHvl4oENtum0Jr2M5wxtC99L2c0ELGPD9WzgxhlgeybhUrO-LueMKSYgBWyhKcT5wydRotxpONeNJaP78t2nA",
      "profile": {
        "bio": {
          "text": "I am a VC"
        }
      },
      "follower_count": 73904,
      "following_count": 187,
      "verifications": [
        "0x2cb5ae51861a4a6e8568b527cafc3891317ac94d"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x2cb5ae51861a4a6e8568b527cafc3891317ac94d"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 239,
      "custody_address": "0xc67925418dc80265720244594c632b258a5c78e8",
      "username": "ted",
      "display_name": "ted (not lasso)",
      "pfp_url": "https://openseauserdata.com/files/fd28c65d9b5192168fb259009a3afd36.png",
      "profile": {
        "bio": {
          "text": "/ted | exploring the onchain frontier | surfing @ venice, ca | eating @ gjusta / gjelina"
        }
      },
      "follower_count": 364597,
      "following_count": 874,
      "verifications": [
        "0x0aa34eb615ab330b64060ff9fa994e72a7a95b59"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x0aa34eb615ab330b64060ff9fa994e72a7a95b59"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 576,
      "custody_address": "0x332e19a3801738fe7bffe22198b40dcd29afd090",
      "username": "nonlinear.eth",
      "display_name": "Jonny Mack",
      "pfp_url": "https://i.seadn.io/gae/oeyOFjLzIVCMec49KdmBp24ZHL82XXqLLDlLRuvUR8InycSpmf9ZtSCfN69lgojeOoucD7fU9cjxAt4raFBTTgSo34gD5lSZ83Klb1k?w=500&auto=format",
      "profile": {
        "bio": {
          "text": "building /fabric"
        }
      },
      "follower_count": 400888,
      "following_count": 3718,
      "verifications": [
        "0xb6f6dce6000ca88cc936b450cedb16a5c15f157f",
        "0xe44f52de82dcdafb86273b463036515b3b7cac84"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xb6f6dce6000ca88cc936b450cedb16a5c15f157f",
          "0xe44f52de82dcdafb86273b463036515b3b7cac84"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 623,
      "custody_address": "0xe9c5c45033d9df9a0c5a87ceb7c707b3f6a17f73",
      "username": "tess",
      "display_name": "Tess 🔴",
      "pfp_url": "https://i.seadn.io/gae/Fga9jcNZ5rOK2oalBEAU96pL15wKyqmAMmbATFT_jW7jTVgKyW8Bv9NulZ9q3rnsMC-iFCK1Li_yoKa3bX_UxbBkR3ZsOcbAH7aMAw?w=500&auto=format",
      "profile": {
        "bio": {
          "text": "product @ optimism • ex-crypto @ ex-twitter "
        }
      },
      "follower_count": 98146,
      "following_count": 238,
      "verifications": [
        "0x8ef4c67724a869dd27234fbc8fb53158d487e00a",
        "0xf112321a6808b1e2ee24f1d8d31b3b0269046baf"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x8ef4c67724a869dd27234fbc8fb53158d487e00a",
          "0xf112321a6808b1e2ee24f1d8d31b3b0269046baf"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 3417,
      "custody_address": "0x9da756c96f1450839307691b8d45a5ae29419aba",
      "username": "bored",
      "display_name": "BORED 🥱",
      "pfp_url": "https://i.imgur.com/UJiQAXu.jpg",
      "profile": {
        "bio": {
          "text": "Benevolent internet pseudonym. AKA @boredelonmusk elsewhere. Founder of EDISON and proprietor of fun. https://edison.wtf/\n"
        }
      },
      "follower_count": 36726,
      "following_count": 677,
      "verifications": [
        "0xf56345338cb4cddaf915ebef3bfde63e70fe3053"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xf56345338cb4cddaf915ebef3bfde63e70fe3053"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 4606,
      "custody_address": "0x088bf0856623b531d1722803d0de5189bb13bdc1",
      "username": "vgr",
      "display_name": "Venkatesh Rao ☀️",
      "pfp_url": "https://i.seadn.io/gae/T-nT2JPzx2mx6bLRETolnn8Vc-D8vdUqDz5vrSPZPIcu5xjFMtIC3qmfU2Kqjfj9W0fNDxVSJQ-tggAWEsI38Gxw-Lxmw4H-osi6IA?w=500&auto=format",
      "profile": {
        "bio": {
          "text": "Blogger at ribbonfarm.com, running summerofprotocols.com, host of /gloom ☀️"
        }
      },
      "follower_count": 122007,
      "following_count": 479,
      "verifications": [
        "0x2503b70933119084c26df4c8d3e96d282de10743"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x2503b70933119084c26df4c8d3e96d282de10743"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 18152,
      "custody_address": "0xaf9b2bd3fc42818fb6bc6bb9046e66edfabbacb3",
      "username": "karalabe.eth",
      "display_name": "Péter Szilágyi",
      "pfp_url": "https://i.imgur.com/98gIliu.jpg",
      "profile": {
        "bio": {
          "text": "Team lead @Ethereum"
        }
      },
      "follower_count": 185151,
      "following_count": 22,
      "verifications": [
        "0x0a13fa23a5ccbabb3817cff029b9b8e843d59f72"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x0a13fa23a5ccbabb3817cff029b9b8e843d59f72"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 189394,
      "custody_address": "0x9a082e7839bcb5975371d2b05c7bfb88b0dc6a40",
      "username": "avichal",
      "display_name": "Avichal Garg",
      "pfp_url": "https://i.imgur.com/CGMJHVE.jpg",
      "profile": {
        "bio": {
          "text": "Entrepreneur, Investing @electric\n\nViews are my own"
        }
      },
      "follower_count": 1498,
      "following_count": 91,
      "verifications": [
        "0x61e2029e46a9d2584bad8093b19bc53572e95d5d"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x61e2029e46a9d2584bad8093b19bc53572e95d5d"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 231990,
      "custody_address": "0x9a86fb4e6f2615cb1adc15153da17323941ffe24",
      "username": "jchervinsky",
      "display_name": "Jake Chervinsky",
      "pfp_url": "https://i.imgur.com/KPDqZCR.jpg",
      "profile": {
        "bio": {
          "text": "CLO @variant"
        }
      },
      "follower_count": 1787,
      "following_count": 110,
      "verifications": [
        "0x7e30fa727bb49771a7bebea9f6761f88ff2c4992"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x7e30fa727bb49771a7bebea9f6761f88ff2c4992"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    }
  ],
  "next": {
    "cursor": "eyJwYWdlIjoxLCJsaW1pdCI6MTUsImNoYW5uZWxLZXkiOiJiYXNlIn0"
  }
}

fid	username	display_name	pfp_url	follower_count	following_count	active_status	power_badge
2	v	Varun Srinivasan		400,163	1,297	inactive	true
3	dwr.eth	Dan Romero		475,914	3,380	inactive	true
24	jesse	Jesse Walden		51,196	245	inactive	true
99	jessepollak	jesse.base.eth 🔵		438,814	1,429	inactive	true
108	nick	Nick Tomaino🎩		91,871	437	inactive	true
160	jack	jack		126,848	391	inactive	true
169	fredwilson.eth	fredwilson		73,904	187	inactive	true
239	ted	ted (not lasso)		364,597	874	inactive	true
576	nonlinear.eth	Jonny Mack		400,888	3,718	inactive	true
623	tess	Tess 🔴		98,146	238	inactive	true
3417	bored	BORED 🥱		36,726	677	inactive	true
4606	vgr	Venkatesh Rao ☀️		122,007	479	inactive	true
18152	karalabe.eth	Péter Szilágyi		185,151	22	inactive	true
189394	avichal	Avichal Garg		1,498	91	inactive	true
231990	jchervinsky	Jake Chervinsky		1,787	110	inactive	true

Field Description

• object: Type of data (in this case, 'user').

• fid: User identifier.

• custody_address: Ethereum address.

• username: Username.

• display_name: Display name.

• pfp_url: Profile picture URL.

• profile: User profile information.

• bio: User introduction text.

• follower_count: Number of followers.

• following_count: Number of users followed.

• verifications: List of verified addresses.

• verified_addresses: List of verified Ethereum and Solana addresses.

• active_status: User's active status (in this case, 'inactive').

• power_badge: Whether the user holds a special badge.