Following

get https://api.neynar.com/v2/farcaster/feed/following

Fetch feed based on who a user is following

Responses

Response body

object

casts

array of objects

required

casts*

object

hash

string

required

parent_hash

string | null

required

parent_url

string | null

required

root_parent_url

string | null

required

parent_author

object

required

author

object

required

text

string

required

timestamp

date-time

required

embeds

array

required

embeds*

type

string

The notification type of a cast.

cast-mention cast-reply

frames

array

frames

reactions

object

required

replies

object

required

thread_hash

string | null

required

mentioned_profiles

array of objects

required

mentioned_profiles*

object

string

required

user

fid

int32

required

The unique identifier of a farcaster user (unsigned integer)

username

string

required

display_name

string

custody_address

string

required

Ethereum address

pfp_url

string

The URL of the user's profile picture

profile

object

required

follower_count

int32

required

The number of followers the user has.

following_count

int32

required

The number of users the user is following.

verifications

array of strings

required

verifications*

verified_addresses

object

required

verified_accounts

array of objects

required

Verified accounts of the user on other platforms, currently only X is supported.

verified_accounts*

object

platform

string

x github

username

string

power_badge

boolean

required

experimental

object

viewer_context

object

Adds context on the viewer's follow relationship with the user.

mentioned_profiles_ranges

array of objects

required

Positions within the text (inclusive start, exclusive end) where each mention occurs.
Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.

mentioned_profiles_ranges*

object

start

number

≥ 0

end

number

≥ 0

mentioned_channels

array of objects

required

mentioned_channels*

object

string

required

name

string

required

object

string

required

channel_dehydrated

image_url

string

viewer_context

object

Adds context on the viewer's or author's role in the channel.

mentioned_channels_ranges

array of objects

required

Positions within the text (inclusive start, exclusive end) where each mention occurs.
Each index within this list corresponds to the same-numbered index in the mentioned_channels list.

mentioned_channels_ranges*

object

start

number

≥ 0

end

number

≥ 0

channel

required

viewer_context

object

Adds context on interactions the viewer has made with the cast.

author_channel_context

object

Adds context on the viewer's or author's role in the channel.

object

required

Returns next cursor

cursor

string | null

required

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://api.neynar.com/v2/farcaster/feed/following?with_recasts=true&limit=25' \
3
     --header 'accept: application/json' \
4
     --header 'x-api-key: NEYNAR_API_DOCS'


xxxxxxxxxx
844
}
1
{
2
  "casts": [
3
    {
4
      "hash": "string",
5
      "parent_hash": "string",
6
      "parent_url": "string",
7
      "root_parent_url": "string",
8
      "parent_author": {
9
        "fid": 0
10
      },
11
      "author": {
12
        "object": "user",
13
        "fid": 3,
14
        "username": "string",
15
        "display_name": "string",
16
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
17
        "pfp_url": "string",
18
        "profile": {
19
          "bio": {
20
            "text": "string",
21
            "mentioned_profiles": [
22
              {
23
                "object": "user_dehydrated",
24
                "fid": 3,
25
                "username": "string",
26
                "display_name": "string",
27
                "pfp_url": "string",
28
                "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
29
              }

200Successful operation.

400Bad Request