Retrieve casts based on filters

farcasterFeed.getFeed

Overview

Retrieve casts based on filters. Ensure setting the correct parameters based on the feed_type and filter_type.

Parameters

name	type	required	Note
feed_type	string	true	"following" or "filter" following (requires fid or address) filter (requires filter_type)
filter_type	string	false	"fids", "parent_url", "channel_id", "embed_url" or "global_trending"
fid	number	false	ex) 3
fids	string	false	ex) "721870, 3"
parent_url	string	false	ex) "https://warpcast.com/~/channel/farcaster"
channel_id	string	false	ex) "lum0x"
embed_url	string	false	ex) "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1b45d600-0075-4494-969c-db5c6f6ce500/original"
with_recasts	boolean	false	false or true
limit	number	false	default: 25, max: 100
cursor	string	false	ex) eyJwYWdlIjoyfQ==
viewer_fid	number	false	ex) 3

Usage

Typescript

let res = await Lum0x.farcasterFeed.getFeed({
    feed_type: "following",
    fid: 721870
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "casts": [
    {
      "object": "cast",
      "hash": "0x80a1b75e1984ba5c31102093a3139eacdb256984",
      "thread_hash": "0x80a1b75e1984ba5c31102093a3139eacdb256984",
      "parent_hash": null,
      "parent_url": "https://warpcast.com/~/channel/replyguys",
      "root_parent_url": "https://warpcast.com/~/channel/replyguys",
      "parent_author": {
        "fid": null
      },
      "author": {
        "object": "user",
        "fid": 324916,
        "custody_address": "0x478d286fcf81da5030549737eae44c65a7784d5f",
        "username": "degenwtf.eth",
        "display_name": "Degen.wtf🎩🐹🩸",
        "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/f0e91a06-2a85-4a5b-f9ab-0c98f14ecd00/original",
        "profile": {
          "bio": {
            "text": "intern @degenpad | /art-layer 🖼 | Meme Posting Lover | 🟣🔵🎩 | Homage of naiivememe "
          }
        },
        "follower_count": 1310,
        "following_count": 497,
        "verifications": [
          "0xcc825984115b92f05464cb8e69424be39a904373",
          "0x9434d5ed552f880a84d812648d1b63509d831aa7",
          "0x528b5ba6437809f548bcc0ef9c1349f41787b0c6"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0xcc825984115b92f05464cb8e69424be39a904373",
            "0x9434d5ed552f880a84d812648d1b63509d831aa7",
            "0x528b5ba6437809f548bcc0ef9c1349f41787b0c6"
          ],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": false,
        "viewer_context": {
          "following": true,
          "followed_by": true
        }
      },
      "text": "It's time to active as a @degenpad intern.\n\nWho do I need to reply?",
      "timestamp": "2024-08-21T18:09:30.000Z",
      "embeds": [],
      "reactions": {
        "likes_count": 4,
        "recasts_count": 0,
        "likes": [
          {
            "fid": 2904,
            "fname": "wake.eth"
          },
          {
            "fid": 9856,
            "fname": "0xluo.eth"
          },
          {
            "fid": 247143,
            "fname": "kylepatrick.eth"
          },
          {
            "fid": 621342,
            "fname": "sillypanda"
          }
        ],
        "recasts": []
      },
      "replies": {
        "count": 2
      },
      "channel": {
        "object": "channel_dehydrated",
        "id": "replyguys",
        "name": "reply guys",
        "image_url": "https://i.imgur.com/xDBupZD.jpg"
      },
      "mentioned_profiles": [
        {
          "object": "user",
          "fid": 434908,
          "custody_address": "0x8eb55f1501eec37b75051ef93b968aa12b2cfb44",
          "username": "degenpad",
          "display_name": "DegenPad🎩🐹",
          "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/6acaa881-827f-40bc-5047-9593b1fa7200/rectcrop3",
          "profile": {
            "bio": {
              "text": "Use your $DEGEN Tips, Support new projects on /degenpad $DPAD\n\nWebsite: https://degenpad.app",
              "mentioned_profiles": []
            }
          },
          "follower_count": 17128,
          "following_count": 77,
          "verifications": [
            "0xd5a589b294b4a1687554faf18572640e6024efe4"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0xd5a589b294b4a1687554faf18572640e6024efe4"
            ],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": true
        }
      ],
      "viewer_context": {
        "liked": false,
        "recasted": false
      }
    },
    {
      "object": "cast",
      "hash": "0x3fa690bdd07333ed291a641ceaf6c4e791c961b6",
      "thread_hash": "0x3fa690bdd07333ed291a641ceaf6c4e791c961b6",
      "parent_hash": null,
      "parent_url": null,
      "root_parent_url": null,
      "parent_author": {
        "fid": null
      },
      "author": {
        "object": "user",
        "fid": 398678,
        "custody_address": "0xa7a2c5ae3b2ef4d9a1b80c28a1084ac97f884dfc",
        "username": "mentats.eth",
        "display_name": "Mentat 🐹",
        "pfp_url": "https://i.imgur.com/kYA4Hyw.jpg",
        "profile": {
          "bio": {
            "text": "Serial Enterpreneur | building /degenpad & /lum0x"
          }
        },
        "follower_count": 637,
        "following_count": 282,
        "verifications": [
          "0x07c7c608b15095a507d7d2f641216030f884c188"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0x07c7c608b15095a507d7d2f641216030f884c188"
          ],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": false,
        "viewer_context": {
          "following": false,
          "followed_by": true
        }
      },
      "text": "More and more and more! \nHappy Building",
      "timestamp": "2024-08-21T15:37:30.000Z",
      "embeds": [
        {
          "cast_id": {
            "fid": 15983,
            "hash": "0xddebed8948eb614039920b9ee6950fd9746f8b5a"
          }
        }
      ],
      "reactions": {
        "likes_count": 3,
        "recasts_count": 1,
        "likes": [
          {
            "fid": 434908,
            "fname": "degenpad"
          },
          {
            "fid": 231317,
            "fname": "elxlee"
          },
          {
            "fid": 243719,
            "fname": "downshift"
          }
        ],
        "recasts": [
          {
            "fid": 434908,
            "fname": "degenpad"
          }
        ]
      },
      "replies": {
        "count": 0
      },
      "channel": null,
      "mentioned_profiles": [],
      "viewer_context": {
        "liked": false,
        "recasted": false
      }
    },
    {
      "object": "cast",
      "hash": "0x16208ddaec00d511f2ff6325d75e98d3ae7b8ea5",
      "thread_hash": "0x16208ddaec00d511f2ff6325d75e98d3ae7b8ea5",
      "parent_hash": null,
      "parent_url": "https://warpcast.com/~/channel/degentokenbase",
      "root_parent_url": "https://warpcast.com/~/channel/degentokenbase",
      "parent_author": {
        "fid": null
      },
      "author": {
        "object": "user",
        "fid": 324916,
        "custody_address": "0x478d286fcf81da5030549737eae44c65a7784d5f",
        "username": "degenwtf.eth",
        "display_name": "Degen.wtf🎩🐹🩸",
        "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/f0e91a06-2a85-4a5b-f9ab-0c98f14ecd00/original",
        "profile": {
          "bio": {
            "text": "intern @degenpad | /art-layer 🖼 | Meme Posting Lover | 🟣🔵🎩 | Homage of naiivememe "
          }
        },
        "follower_count": 1310,
        "following_count": 497,
        "verifications": [
          "0xcc825984115b92f05464cb8e69424be39a904373",
          "0x9434d5ed552f880a84d812648d1b63509d831aa7",
          "0x528b5ba6437809f548bcc0ef9c1349f41787b0c6"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0xcc825984115b92f05464cb8e69424be39a904373",
            "0x9434d5ed552f880a84d812648d1b63509d831aa7",
            "0x528b5ba6437809f548bcc0ef9c1349f41787b0c6"
          ],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": false,
        "viewer_context": {
          "following": true,
          "followed_by": true
        }
      },
      "text": "What a big move.\n\nThe first 'Public Interest ITO' partner for Multi-ITO is @bountycaster founded by @linda.\n\nPlease check carefully:\n\n- Bountycaster does not have its own token.\n- Users tipping in the Bountycaster ITO are supporting a public interest project and will be eligible for an airdrop from the $DPAD Ecosystem Fund.",
      "timestamp": "2024-08-21T12:54:38.000Z",
      "embeds": [
        {
          "cast_id": {
            "fid": 434908,
            "hash": "0xfce01ed34adbc305a98015309d3d73d2e8a6615f"
          }
        }
      ],
      "reactions": {
        "likes_count": 7,
        "recasts_count": 1,
        "likes": [
          {
            "fid": 15983,
            "fname": "jacek"
          },
          {
            "fid": 434908,
            "fname": "degenpad"
          },
          {
            "fid": 324916,
            "fname": "degenwtf.eth"
          },
          {
            "fid": 12,
            "fname": "linda"
          },
          {
            "fid": 544677,
            "fname": "mugiwaraboshi.eth"
          }
        ],
        "recasts": [
          {
            "fid": 434908,
            "fname": "degenpad"
          }
        ]
      },
      "replies": {
        "count": 0
      },
      "channel": {
        "object": "channel_dehydrated",
        "id": "degentokenbase",
        "name": "$DEGEN",
        "image_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/8c956aaf-d633-4544-42bd-9ab938854600/original"
      },
      "mentioned_profiles": [
        {
          "object": "user",
          "fid": 20589,
          "custody_address": "0xd9af94bafd588ab897c5b6aa1de151a010de4775",
          "username": "bountycaster",
          "display_name": "Bountycaster",
          "pfp_url": "https://i.imgur.com/QcV4VJu.jpg",
          "profile": {
            "bio": {
              "text": "Bounties and services on Farcaster bountycaster.xyz. Tag @bountybot to post and check out /bounties. FAQ: bountycaster.xyz/FAQ",
              "mentioned_profiles": []
            }
          },
          "follower_count": 3838,
          "following_count": 2,
          "verifications": [],
          "verified_addresses": {
            "eth_addresses": [],
            "sol_addresses": []
          },
          "active_status": "inactive",
          "power_badge": false
        },
        {
          "object": "user",
          "fid": 12,
          "custody_address": "0xb43575d58c49d2be880e0f821ddf51d15c13c376",
          "username": "linda",
          "display_name": "Linda Xie",
          "pfp_url": "https://i.seadn.io/gae/r6CW_kgQygQhI7-4JdWt_Nbf_bjFNnEM7dSns1nZGrijJvUMaLnpAFuBLwjsHXTkyX8zfgpRJCYibtm7ojeA2_ASQwSJgh7yKEFVMOI?w=500&auto=format",
          "profile": {
            "bio": {
              "text": "Co-founder @bountycaster (bountycaster.xyz). Co-producer @ethereumfilm. Previously co-founder of Scalar Capital and product at Coinbase",
              "mentioned_profiles": []
            }
          },
          "follower_count": 382393,
          "following_count": 650,
          "verifications": [
            "0x5e349eca2dc61abcd9dd99ce94d04136151a09ee"
          ],
          "verified_addresses": {
            "eth_addresses": [
              "0x5e349eca2dc61abcd9dd99ce94d04136151a09ee"
            ],
            "sol_addresses": [
              "AAobwFcj4HtJBaCBq5btL55rMPUZMQSwRbFJ9vTYDpcT"
            ]
          },
          "active_status": "inactive",
          "power_badge": true
        }
      ],
      "viewer_context": {
        "liked": false,
        "recasted": false
      }
    }
  ],
  "next": {
    "cursor": "eyJ0aW1lc3RhbXAiOiIyMDI0LTA4LTIxIDE4OjA0OjU4LjAwMDAwMDAifQ%3D%3D"
  }
}

게시물 요약

작성자	내용	채널	타임스탬프	좋아요 수	리캐스트 수	댓글 수	언급된 프로필
Degen.wtf🎩🐹🩸	"It's time to active as a @degenpad intern. Who do I need to reply?"	Reply Guys	2024-08-21 18:09 UTC	4	0	2	DegenPad🎩🐹
Mentat 🐹	"More and more and more! Happy Building"	없음	2024-08-21 15:37 UTC	3	1	0	없음
Degen.wtf🎩🐹🩸	"What a big move. The first 'Public Interest ITO' partner for Multi-ITO is @bountycaster founded by @linda. Please check carefully: - Bountycaster does not have its own token. - Users tipping in the Bountycaster ITO are supporting a public interest project and will be eligible for an airdrop from the $DPAD Ecosystem Fund."	DegenTokenBase	2024-08-21 12:54 UTC	7	1	0	Bountycaster, Linda Xie

Field Description

• Hash: The unique identifier of the cast.

• Author: The name of the cast's author.

• Text: The content of the cast.

• Timestamp: The date and time when the cast was created.

• Reactions Count: The number of reactions (e.g., likes) the cast has received.

• Recasts Count: The number of times the cast has been recast.

• Replies Count: The number of replies to the cast.

• Channel Name: The name of the channel where the cast was posted.

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

• Embed URL: The URL of embedded content related to the cast (if applicable).