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
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.
Last updated
