Neynar Documentation

Channels are “subreddits inside Farcaster.” Technically, a channel is a collection of casts that share a common channel_id. For example, the memes channel is a collection of casts that share the channel_id memes.

Fetching Casts from a Channel

This guide demonstrates how to use the Neynar SDK to fetch casts from a channel. Check out this Getting started guide to learn how to set up your environment and get an API key. First, initialize the client:

// npm i @neynar/nodejs-sdk
import { NeynarAPIClient, Configuration } from "@neynar/nodejs-sdk";
import { FeedType,FilterType } from "@neynar/nodejs-sdk/build/api/index.js";

// make sure to set your NEYNAR_API_KEY .env
// don't have an API key yet? get one at neynar.com
const config = new Configuration({
  apiKey: process.env.NEYNAR_API_KEY,
});

const client = new NeynarAPIClient(config);

Then, fetch the feed in the memes channel.

const client = new NeynarAPIClient(config);
const channelId = "memes";
const filterType = FilterType.ChannelId;

const feed = await client.fetchFeed({
  feedType: FeedType.Filter,
  filterType,
  channelId,
});

console.log(feed);

Example output:

{
  casts: [
    {
      object: "cast_hydrated",
    hash: "0xf17168571d5e403f3b608ea2cc09a0b711d4c4fc",
    thread_hash: "0xf17168571d5e403f3b608ea2cc09a0b711d4c4fc",
    parent_hash: null,
    parent_url: "chain://eip155:1/erc721:0xfd8427165df67df6d7fd689ae67c8ebf56d9ca61",
    parent_author: [Object ...],
    author: [Object ...],
    text: "",
    timestamp: "2023-11-27T14:40:12.000Z",
    embeds: [
      [Object ...]
    ],
    reactions: [Object ...],
    replies: [Object ...],
    mentioned_profiles: []
  }, {
    object: "cast_hydrated",
    hash: "0x344dcd9c7c2671450628aacd0bbb8e29ea2e8809",
    thread_hash: "0x344dcd9c7c2671450628aacd0bbb8e29ea2e8809",
    parent_hash: null,
    parent_url: "chain://eip155:1/erc721:0xfd8427165df67df6d7fd689ae67c8ebf56d9ca61",
    parent_author: [Object ...],
    author: [Object ...],
    text: "sorry",
    timestamp: "2023-11-27T14:24:32.000Z",
    embeds: [
      [Object ...]
    ],
    reactions: [Object ...],
    replies: [Object ...],
    mentioned_profiles: []
  }, {
    object: "cast_hydrated",
    hash: "0x68b94ec2a10ebad8b13e3b673f0db02dd3280f42",
    thread_hash: "0x68b94ec2a10ebad8b13e3b673f0db02dd3280f42",
    parent_hash: null,
    parent_url: "chain://eip155:1/erc721:0xfd8427165df67df6d7fd689ae67c8ebf56d9ca61",
    parent_author: [Object ...],
    author: [Object ...],
    text: "man today is such a nice morning",
    timestamp: "2023-11-27T13:30:11.000Z",
    embeds: [
      [Object ...]
    ],
    reactions: [Object ...],
    replies: [Object ...],
    mentioned_profiles: []
  }
],
next: {
  cursor: "eyJ0aW1lc3RhbXAiOiIyMDIzLTExLTI3IDEzOjMwOjExLjAwMDAwMDAifQ=="
}
}

To fetch the next page of the feed, use the cursor:

const nextFeed = await client.fetchFeed({
 feedType: FeedType.Filter,
  filterType: FilterType.ChannelId,
  channelId,
  cursor: feed.next.cursor,
});

There you go! You now know how to fetch casts from a Farcaster channel with Neynar SDK.

Ready to start building?

Get your subscription at neynar.com and reach out to us on Slack with any questions!

Get Started

Build Bots and Agents

Build Farcaster Mini Apps

Fetch User Information

Fetch Cast Information

Fetch Farcaster Feeds

Onboard New Users

Write Data to Farcaster

Filter Spam, Low Quality Data

Host Farcaster Mini Apps

Run Queries on FC Data

Render Farcaster in React

Get Events Via Webhooks

Fetch Notifications

Create Onchain Transactions

Intersect Onchain & Social Data

Write Direct Casts

Get Farcaster Storage Data

Publish Actions on FC Apps

Get Farcaster Data on Base

Explore Network Health

Get Hypersub Subscriptions

Contribute To Development

Fetch & Display Farcaster Feeds with Neynar API

Fetching Casts from a Channel

Ready to start building?

​Related API reference Fetch Feed by Channel IDs

​Fetching Casts from a Channel

​Ready to start building?

Related API reference Fetch Feed by Channel IDs

Fetching Casts from a Channel

Ready to start building?