(Bulk) Retrieve channels by id or parent_url

farcasterChannel.getChannelBulkSearch

Overview

Returns details of multiple channels

Parameters

name	type	required	Note
ids	string	true	ex) "lum0x, base"
type	string	false	"id" or "parent_url"
viewer_fid	number	false	ex) 3

Usage

Typescript

let res = await Lum0x.farcasterChannel.getChannelBulkSearch({
    ids: "lum0x, base",
    type: "id"
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "channels": [
    {
      "id": "base",
      "url": "https://onchainsummer.xyz",
      "name": "Base",
      "description": "Bringing the world onchain — a community of builders on Base",
      "follower_count": 391666,
      "object": "channel",
      "image_url": "https://warpcast.com/~/channel-images/base.png",
      "created_at": 1692300191,
      "parent_url": "https://onchainsummer.xyz",
      "lead": {
        "object": "user",
        "fid": 12142,
        "custody_address": "0x04e6f111ebf6fd25576d480480962435dc3aa8d8",
        "username": "base",
        "display_name": "Base",
        "pfp_url": "https://i.imgur.com/7Q0QBrm.jpg",
        "profile": {
          "bio": {
            "text": "base.org"
          }
        },
        "follower_count": 117010,
        "following_count": 172,
        "verifications": [
          "0x9652721d02b9db43f4311102820158abb4ecc95b"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0x9652721d02b9db43f4311102820158abb4ecc95b"
          ],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": true
      },
      "hosts": [
        {
          "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": 12144,
          "custody_address": "0x0932174aeb21e30826acc5976cf7602b74c82051",
          "username": "wbnns",
          "display_name": "wbnns 🔵",
          "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/5a23a326-8572-400d-348c-6e1b615a6c00/original",
          "profile": {
            "bio": {
              "text": "Working on Base.org (@base) • Former maintainer: Bitcoin.org • Editor: Mastering Bitcoin & Mastering Ethereum • Maker & developer: github.com/wbnns"
            }
          },
          "follower_count": 10041,
          "following_count": 0,
          "verifications": [
            "0x60ec4fd8069513f738f3a0f41b9e00c294e74bf3"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x60ec4fd8069513f738f3a0f41b9e00c294e74bf3"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": true
        },
        {
          "object": "user",
          "fid": 3895,
          "custody_address": "0x23a2ef10fbe3d24a900d24065136f1728bb11b3b",
          "username": "drewcoffman.eth",
          "display_name": "drewcoffman",
          "pfp_url": "https://i.imgur.com/b1MXNMY.jpg",
          "profile": {
            "bio": {
              "text": "@base // ☻ "
            }
          },
          "follower_count": 70310,
          "following_count": 696,
          "verifications": [
            "0xc7a0d765c3af6e2710ba05a56c5e2ca190c2e11e"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0xc7a0d765c3af6e2710ba05a56c5e2ca190c2e11e"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": true
        },
        {
          "object": "user",
          "fid": 12142,
          "custody_address": "0x04e6f111ebf6fd25576d480480962435dc3aa8d8",
          "username": "base",
          "display_name": "Base",
          "pfp_url": "https://i.imgur.com/7Q0QBrm.jpg",
          "profile": {
            "bio": {
              "text": "base.org"
            }
          },
          "follower_count": 117010,
          "following_count": 172,
          "verifications": [
            "0x9652721d02b9db43f4311102820158abb4ecc95b"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x9652721d02b9db43f4311102820158abb4ecc95b"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": true
        },
        {
          "object": "user",
          "fid": 211241,
          "custody_address": "0xbfcd5b6a151ad8793d0a1c5a7e3793e1d8528077",
          "username": "svmvn",
          "display_name": "simon.base.eth",
          "pfp_url": "https://ipfs.decentralized-content.com/ipfs/QmW5kdX4LcFhsZga3P38gwL1BidqyvqfkSTESuTB6DBm7b/1631.png",
          "profile": {
            "bio": {
              "text": "cat lover & jpeg enjoyer | TPM @coinbase — building communities @base"
            }
          },
          "follower_count": 430,
          "following_count": 249,
          "verifications": [
            "0x79f0b4c45d2bee63a468baa69cfe77c27c832737",
            "0x7c7d0e58ed015da0ee5b49c2b915f288ec8cd348"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x79f0b4c45d2bee63a468baa69cfe77c27c832737",
              "0x7c7d0e58ed015da0ee5b49c2b915f288ec8cd348"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false
        },
        {
          "object": "user",
          "fid": 17318,
          "custody_address": "0x760b0447963811173ff87a4ac098bacf173bbe48",
          "username": "patty",
          "display_name": "Pat",
          "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/e9e9e452-f44a-4246-4d41-8917ef9d8600/original",
          "profile": {
            "bio": {
              "text": "helping builders create the onchain global economy powered by @base"
            }
          },
          "follower_count": 391,
          "following_count": 80,
          "verifications": [
            "0xb6d00d83158fee6695c72ff9c5e915478a479224"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0xb6d00d83158fee6695c72ff9c5e915478a479224"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false
        },
        {
          "object": "user",
          "fid": 368422,
          "custody_address": "0x16d25ca06a054fc7752e1ae63ca8b23ce6fa2da4",
          "username": "automod",
          "display_name": "automod",
          "pfp_url": "https://i.imgur.com/K1SLPRA.jpg",
          "profile": {
            "bio": {
              "text": "automod.sh — power tools for your channel. Setup in < 2min."
            }
          },
          "follower_count": 4872,
          "following_count": 65,
          "verifications": [],
          "verified_addresses": {
            "eth_addresses": [],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false
        },
        {
          "object": "user",
          "fid": 17106,
          "custody_address": "0x7d7536ab366a2870a0fa85a14da5b07a6864dcf7",
          "username": "consecution.eth",
          "display_name": "Ryan",
          "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/61c54c4b-90f5-428c-6324-a39e7225de00/original",
          "profile": {
            "bio": {
              "text": "builder"
            }
          },
          "follower_count": 1355,
          "following_count": 309,
          "verifications": [
            "0x058f4718624fcc5006d89ecc8c76e5baf5320590"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x058f4718624fcc5006d89ecc8c76e5baf5320590"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false
        }
      ],
      "moderator": {
        "object": "user",
        "fid": 565060,
        "custody_address": "0xb9f71ab62fc7a507f5567dc86fe7a40f2647619e",
        "username": "automod-ringo",
        "display_name": "Automod",
        "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/9ff1423e-bdba-4bb8-7ce2-b87268e6df00/rectcrop3",
        "profile": {
          "bio": {
            "text": "automod.sh\n\nstandard"
          }
        },
        "follower_count": 159,
        "following_count": 92,
        "verifications": [],
        "verified_addresses": {
          "eth_addresses": [],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": false
      }
    }
  ]
}

Field	Channel ID	URL	Name	Description	Follower Count	Image URL	Created At	Parent URL	Lead User Details	Host User Details	Moderator Details
Channel Object	base	Link	Base	Bringing the world onchain — a community of builders on Base	391,666		2023-08-17	Link	Username: base Display Name: Base Follower Count: 117,010 Profile Picture:	Username: jessepollak Display Name: jesse.base.eth 🔵 Follower Count: 438,814 Profile Picture: Bio: @base builder #001; onchain cities w/ OAK & city3 Username: wbnns Display Name: wbnns 🔵 Follower Count: 10,041 Profile Picture: Bio: Working on Base.org (@base) • Former maintainer: Bitcoin.org • Editor: Mastering Bitcoin & Mastering Ethereum • Maker & developer: github.com/wbnns Username: drewcoffman.eth Display Name: drewcoffman Follower Count: 70,310 Profile Picture: Bio: @base // ☻ Username: base Display Name: Base Follower Count: 117,010 Profile Picture: Bio: base.org Username: svmvn Display Name: simon.base.eth Follower Count: 430 Profile Picture: Bio: cat lover & jpeg enjoyer	TPM @coinbase — building communities @base Username: patty Display Name: Pat Follower Count: 391 Profile Picture: Bio: helping builders create the onchain global economy powered by @base Username: automod Display Name: automod Follower Count: 4,872 Profile Picture: Bio: automod.sh — power tools for your channel. Setup in < 2min.
Moderator Details										Username: automod-ringo Display Name: Automod Follower Count: 159 Profile Picture: Bio: automod.sh

Field Description

• Channel ID: The unique identifier of the channel.

• URL: The website link to the channel.

• Name: The name of the channel.

• Description: The description of the channel.

• Follower Count: The number of followers of the channel.

• Image URL: The URL of the channel's representative image.

• Created At: The date the channel was created, represented as a Unix timestamp.

• Parent URL: The URL of the parent channel.

• Lead User Details: Details about the primary user of the channel.

• Host User Details: Details about the host users of the channel, including information for multiple users.

• Moderator Details: Details about the channel's moderators.