Retrieve casts for a given user

farcasterCast.getCastsByFid

Overview

Retrieve casts for a given user FID in reverse chronological order. Also allows filtering by parent_url and channel

Parameters

name	type	required	Note
fid	number	true	ex) 721870
parent_url	string	false	ex) "https://warpcast.com/~/channel/farcaster"
viewer_fid	number	false	ex) 3
limit	number	false	ex) default: 25, max: 150
cursor	string	false	ex) eyJwYWdlIjoyfQ==

Usage

Typescript

let res = await Lum0x.farcasterCast.getCastsByFid({
    fid: 721870,
    limit: 3
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "result": {
    "casts": [
      {
        "hash": "0x3789c6c250ed23383a75268a837b52055da27195",
        "parentHash": "0x77ed5a4d3513de3228ab18844ee73a034e506b62",
        "parentUrl": null,
        "rootParentUrl": "https://onchainsummer.xyz",
        "threadHash": "0x77ed5a4d3513de3228ab18844ee73a034e506b62",
        "parentAuthor": {
          "fid": 721870
        },
        "author": {
          "fid": 721870,
          "custodyAddress": "0x63cd09948b05e5d8367226b0c83a16b583862191",
          "username": "lum0x",
          "displayName": "Lum0x",
          "pfp": {
            "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/74970e01-bcf7-4ef7-31d7-238f5814b200/original"
          },
          "profile": {
            "bio": {
              "text": "illuminate your builder journey with Lum0x 💡\n\nhttps://lum0x.com/",
              "mentionedProfiles": []
            }
          },
          "followerCount": 55,
          "followingCount": 2,
          "verifications": [],
          "verifiedAddresses": {
            "eth_addresses": [],
            "sol_addresses": []
          },
          "activeStatus": "inactive",
          "powerBadge": false
        },
        "text": "Thank you Partners! 🥰 \n@degenpad @kroma-network @neynar @mintclub @checkin @codatta @iskra @nonceclassic @phaverapp @tako",
        "timestamp": "2024-09-06T11:19:29.000Z",
        "embeds": [],
        "mentionedProfiles": [
          {
            "fid": 434908,
            "custodyAddress": "0x8eb55f1501eec37b75051ef93b968aa12b2cfb44",
            "username": "degenpad",
            "displayName": "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",
                "mentionedProfiles": []
              }
            },
            "followerCount": 17290,
            "followingCount": 83,
            "verifications": [
              "0xd5a589b294b4a1687554faf18572640e6024efe4"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0xd5a589b294b4a1687554faf18572640e6024efe4"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": true
          },
          {
            "fid": 662916,
            "custodyAddress": "0x940ed4f9c1bbdc209111efea58d1e88c2618d9ae",
            "username": "kroma-network",
            "displayName": "Kroma(✳️_✳️)",
            "pfp": {
              "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/aec7a067-7122-48fd-23dd-8cc18a5c0b00/rectcrop3"
            },
            "profile": {
              "bio": {
                "text": "Optimistic Rollup utilizing zkEVM 🌐 | Built on the Superchain 🟢🔴\nhttps://kroma.network/",
                "mentionedProfiles": []
              }
            },
            "followerCount": 877,
            "followingCount": 3,
            "verifications": [],
            "verifiedAddresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 6131,
            "custodyAddress": "0xa6a8736f18f383f1cc2d938576933e5ea7df01a1",
            "username": "neynar",
            "displayName": "Neynar",
            "pfp": {
              "url": "https://i.imgur.com/UjBZ3pV.png"
            },
            "profile": {
              "bio": {
                "text": "best farcaster developers build on neynar.com | /neynar",
                "mentionedProfiles": []
              }
            },
            "followerCount": 5793,
            "followingCount": 47,
            "verifications": [
              "0xa6a8736f18f383f1cc2d938576933e5ea7df01a1"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0xa6a8736f18f383f1cc2d938576933e5ea7df01a1"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 562300,
            "custodyAddress": "0x834f2578f5dd0d9d92802bfa29d0239dcf0b2ab4",
            "username": "mintclub",
            "displayName": "Mint Club Intern",
            "pfp": {
              "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/c86e57ec-c1a6-4778-03ef-d8eef55f8600/original"
            },
            "profile": {
              "bio": {
                "text": "Unofficial Intern at mint.club & part-time at hunt.town ...",
                "mentionedProfiles": []
              }
            },
            "followerCount": 1720,
            "followingCount": 213,
            "verifications": [
              "0x78288587be28b78befee7923423be6384b4e3b4e"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0x78288587be28b78befee7923423be6384b4e3b4e"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": true
          },
          {
            "fid": 388302,
            "custodyAddress": "0x611f4faea2de69886baf2d8d0515a5267009df3e",
            "username": "checkin",
            "displayName": "Checkin - Checkin and Earn",
            "pfp": {
              "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/5b2df6e7-5496-470f-b6f4-05f8f93e6200/rectcrop3"
            },
            "profile": {
              "bio": {
                "text": "Checkin and Earn on Farcaster - Check into spots, explore what’s nearby, and connect with your friends on the go!\n\n📍https://app.checkin.gg",
                "mentionedProfiles": []
              }
            },
            "followerCount": 7180,
            "followingCount": 123,
            "verifications": [
              "0xfd8af1b687cb42dc82663a45b78be2a17c9791e8"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0xfd8af1b687cb42dc82663a45b78be2a17c9791e8"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 803870,
            "custodyAddress": "0xe5436f428cd5dcb02125a006ba78a46f55c47a23",
            "username": "codatta",
            "displayName": "Codatta",
            "pfp": {
              "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/d2f5b97c-ee3d-4ff1-b647-68815b83ec00/rectcrop3"
            },
            "profile": {
              "bio": {
                "text": "Universal annotation and labeling protocol that turns your intelligence into AI /codatta \n\n",
                "mentionedProfiles": []
              }
            },
            "followerCount": 62,
            "followingCount": 98,
            "verifications": [
              "0x24a903b1661550a64bc1cec0b29fc2e9f413409f"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0x24a903b1661550a64bc1cec0b29fc2e9f413409f"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 415795,
            "custodyAddress": "0x4e75aec25d883ba97e9ee08016954e005a0c5904",
            "username": "iskra",
            "displayName": "Iskra World",
            "pfp": {
              "url": "https://i.imgur.com/ayL8XUG.jpg"
            },
            "profile": {
              "bio": {
                "text": "Iskra is the premier destination in Web3 gaming for both players and developers. 🎮🚀",
                "mentionedProfiles": []
              }
            },
            "followerCount": 48,
            "followingCount": 62,
            "verifications": [],
            "verifiedAddresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 191376,
            "custodyAddress": "0x2943afcdb74eee21c79ba8838f5b08d9ae51e538",
            "username": "nonceclassic",
            "displayName": "nonce classic",
            "pfp": {
              "url": "https://i.imgur.com/9F80ZPk.jpg"
            },
            "profile": {
              "bio": {
                "text": "web3-native venture capital firm",
                "mentionedProfiles": []
              }
            },
            "followerCount": 43,
            "followingCount": 56,
            "verifications": [],
            "verifiedAddresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 236812,
            "custodyAddress": "0x1eb8b3b216ed9552c49ec45a4bfdd8e4917c38b9",
            "username": "phaverapp",
            "displayName": "Phaver 🦄",
            "pfp": {
              "url": "https://i.imgur.com/EkNZ4ZJ.jpg"
            },
            "profile": {
              "bio": {
                "text": "The largest multiprotocol web3 social app 📲\n\nWith cross-posting to both Farcaster and Lens 🟣🌿 https://phaver.app.link/phaver",
                "mentionedProfiles": []
              }
            },
            "followerCount": 13710,
            "followingCount": 126,
            "verifications": [],
            "verifiedAddresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          },
          {
            "fid": 13475,
            "custodyAddress": "0x60c2d2e58219709c062c2151ad41e219a7c3cc9e",
            "username": "tako",
            "displayName": "Takocast",
            "pfp": {
              "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/66a03f72-603b-4055-d542-9a0eb3f32500/original"
            },
            "profile": {
              "bio": {
                "text": "A Chinese-Friendly Client Powered by Tako Protocol 🐙 | web3 华语社交App | 让东西方交流再无障碍 takocast.xyz on PC",
                "mentionedProfiles": []
              }
            },
            "followerCount": 1014,
            "followingCount": 632,
            "verifications": [],
            "verifiedAddresses": {
              "eth_addresses": [],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          }
        ],
        "reactions": {
          "count": 2,
          "fids": [
            562300,
            388302
          ],
          "fnames": [
            "mintclub",
            "checkin"
          ]
        },
        "recasts": {
          "count": 0,
          "fids": []
        },
        "recasters": [],
        "replies": {
          "count": 0
        },
        "channel": {
          "object": "channel_dehydrated",
          "id": "base",
          "name": "Base",
          "image_url": "https://warpcast.com/~/channel-images/base.png"
        }
      },
      {
        "hash": "0x77ed5a4d3513de3228ab18844ee73a034e506b62",
        "parentHash": null,
        "parentUrl": "https://onchainsummer.xyz",
        "rootParentUrl": "https://onchainsummer.xyz",
        "threadHash": "0x77ed5a4d3513de3228ab18844ee73a034e506b62",
        "parentAuthor": {
          "fid": null
        },
        "author": {
          "fid": 721870,
          "custodyAddress": "0x63cd09948b05e5d8367226b0c83a16b583862191",
          "username": "lum0x",
          "displayName": "Lum0x",
          "pfp": {
            "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/74970e01-bcf7-4ef7-31d7-238f5814b200/original"
          },
          "profile": {
            "bio": {
              "text": "illuminate your builder journey with Lum0x 💡\n\nhttps://lum0x.com/",
              "mentionedProfiles": []
            }
          },
          "followerCount": 55,
          "followingCount": 2,
          "verifications": [],
          "verifiedAddresses": {
            "eth_addresses": [],
            "sol_addresses": []
          },
          "activeStatus": "inactive",
          "powerBadge": false
        },
        "text": "🥳 It's a wrap! \nFarSight Summit has concluded, with a glimpse into the future of @base & @farcaster ! \n\nConnections made, ideas shared, and the enthusiasm we witnessed left us in awe. \n\nCheck out the full recap 👇\n\nhttps://mirror.xyz/0x0afC7678e6C6c23f6A7e5238d00a3319d97a5516/REwUa-jz7Vp3mkEzcEJYo1-z_7KeqNq1jDVYIlCEGbw",
        "timestamp": "2024-09-06T10:39:03.000Z",
        "embeds": [
          {
            "url": "https://mirror.xyz/0x0afC7678e6C6c23f6A7e5238d00a3319d97a5516/REwUa-jz7Vp3mkEzcEJYo1-z_7KeqNq1jDVYIlCEGbw",
            "metadata": {
              "content_type": "text/html;charset=utf-8",
              "content_length": null,
              "_status": "RESOLVED",
              "html": {
                "charset": "utf-8",
                "favicon": "/favicon.ico",
                "ogImage": [
                  {
                    "url": "https://images.mirror-media.xyz/publication-images/MyOtQZ84FIcWw__aTy_xl.jpeg?height=1920&width=3840",
                    "type": "jpeg"
                  }
                ],
                "ogTitle": "FarSight Summit Recap: Base & Farcaster Community Event",
                "twitterCard": "summary_large_image",
                "ogDescription": "On September 3rd, amidst the bustling Korea Blockchain Week, the FarSight Summit brought together the global Base & Farcaster community in the heart of Seoul's Gangnam district."
              }
            }
          }
        ],
        "mentionedProfiles": [
          {
            "fid": 12142,
            "custodyAddress": "0x04e6f111ebf6fd25576d480480962435dc3aa8d8",
            "username": "base",
            "displayName": "Base",
            "pfp": {
              "url": "https://i.imgur.com/7Q0QBrm.jpg"
            },
            "profile": {
              "bio": {
                "text": "base.org",
                "mentionedProfiles": []
              }
            },
            "followerCount": 119164,
            "followingCount": 177,
            "verifications": [
              "0x9652721d02b9db43f4311102820158abb4ecc95b"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0x9652721d02b9db43f4311102820158abb4ecc95b"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": true
          },
          {
            "fid": 1,
            "custodyAddress": "0x8773442740c17c9d0f0b87022c722f9a136206ed",
            "username": "farcaster",
            "displayName": "Farcaster",
            "pfp": {
              "url": "https://i.imgur.com/I2rEbPF.png"
            },
            "profile": {
              "bio": {
                "text": "A sufficiently decentralized social network. farcaster.xyz",
                "mentionedProfiles": []
              }
            },
            "followerCount": 22166,
            "followingCount": 2,
            "verifications": [
              "0x86924c37a93734e8611eb081238928a9d18a63c0"
            ],
            "verifiedAddresses": {
              "eth_addresses": [
                "0x86924c37a93734e8611eb081238928a9d18a63c0"
              ],
              "sol_addresses": []
            },
            "activeStatus": "inactive",
            "powerBadge": false
          }
        ],
        "reactions": {
          "count": 10,
          "fids": [
            769628,
            363979,
            530702,
            662916,
            500988,
            388302,
            99,
            321762,
            562300,
            434908
          ],
          "fnames": [
            "lotusmarket",
            "yyg",
            "farooqueali",
            "kroma-network",
            "evee",
            "checkin",
            "jessepollak",
            "amyk",
            "mintclub",
            "degenpad"
          ]
        },
        "recasts": {
          "count": 1,
          "fids": [
            500988
          ]
        },
        "recasters": [
          "evee"
        ],
        "replies": {
          "count": 3
        },
        "frames": [
          {
            "version": "vNext",
            "title": "FarSight Summit Recap: Base & Farcaster Community Event",
            "image": "https://mirror.xyz/api/frame/images/entry-square?projectAddress=0x0afC7678e6C6c23f6A7e5238d00a3319d97a5516&title=FarSight+Summit+Recap%3A+Bringing+the+Base+%26+Farcaster+Community+Together&featuredImageUrl=https%3A%2F%2Fimages.mirror-media.xyz%2Fpublication-images%2FMyOtQZ84FIcWw__aTy_xl.jpeg%3Fheight%3D1920%26width%3D3840",
            "image_aspect_ratio": "1:1",
            "buttons": [
              {
                "index": 1,
                "title": "Mint",
                "action_type": "post_redirect"
              },
              {
                "index": 2,
                "title": "Read on Mirror",
                "action_type": "post_redirect"
              },
              {
                "index": 3,
                "title": "Subscribe 🔔",
                "action_type": "post"
              }
            ],
            "input": {},
            "state": {},
            "post_url": "https://mirror.xyz/api/frame/entry/initial-wnft?projectAddress=0x0afC7678e6C6c23f6A7e5238d00a3319d97a5516&digest=REwUa-jz7Vp3mkEzcEJYo1-z_7KeqNq1jDVYIlCEGbw",
            "frames_url": "https://mirror.xyz/0x0afC7678e6C6c23f6A7e5238d00a3319d97a5516/REwUa-jz7Vp3mkEzcEJYo1-z_7KeqNq1jDVYIlCEGbw"
          }
        ],
        "channel": {
          "object": "channel_dehydrated",
          "id": "base",
          "name": "Base",
          "image_url": "https://warpcast.com/~/channel-images/base.png"
        }
      },
      {
        "hash": "0x898c3653d3c5537435835471d69d4eafd17f649a",
        "parentHash": null,
        "parentUrl": "https://warpcast.com/~/channel/farsightsummit",
        "rootParentUrl": "https://warpcast.com/~/channel/farsightsummit",
        "threadHash": "0x898c3653d3c5537435835471d69d4eafd17f649a",
        "parentAuthor": {
          "fid": null
        },
        "author": {
          "fid": 721870,
          "custodyAddress": "0x63cd09948b05e5d8367226b0c83a16b583862191",
          "username": "lum0x",
          "displayName": "Lum0x",
          "pfp": {
            "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/74970e01-bcf7-4ef7-31d7-238f5814b200/original"
          },
          "profile": {
            "bio": {
              "text": "illuminate your builder journey with Lum0x 💡\n\nhttps://lum0x.com/",
              "mentionedProfiles": []
            }
          },
          "followerCount": 55,
          "followingCount": 2,
          "verifications": [],
          "verifiedAddresses": {
            "eth_addresses": [],
            "sol_addresses": []
          },
          "activeStatus": "inactive",
          "powerBadge": false
        },
        "text": "Raffle coming soon.... 👀 \nwill be running the raffle at the end of the event today! \nhttps://farsight-summit-lum0x-raffle.vercel.app/api",
        "timestamp": "2024-09-03T09:13:00.000Z",
        "embeds": [
          {
            "url": "https://farsight-summit-lum0x-raffle.vercel.app/api",
            "metadata": {
              "content_type": "text/html;charset=utf-8",
              "content_length": null,
              "_status": "RESOLVED",
              "html": {
                "charset": "ASCII",
                "ogImage": [
                  {
                    "url": "https://farsight-summit-lum0x-raffle.vercel.app/Default.png",
                    "type": "png"
                  }
                ],
                "ogTitle": "Raffle among your fans",
                "ogLocale": "en"
              }
            }
          }
        ],
        "mentionedProfiles": [],
        "reactions": {
          "count": 5,
          "fids": [
            500988,
            562300,
            8151,
            253540,
            544677
          ],
          "fnames": [
            "evee",
            "mintclub",
            "sebayaki.eth",
            "kmayor",
            "mugiwaraboshi.eth"
          ]
        },
        "recasts": {
          "count": 1,
          "fids": [
            500988
          ]
        },
        "recasters": [
          "evee"
        ],
        "replies": {
          "count": 0
        },
        "frames": [
          {
            "version": "vNext",
            "title": "Raffle among your fans",
            "image": "https://farsight-summit-lum0x-raffle.vercel.app/Default.png",
            "image_aspect_ratio": "1:1",
            "buttons": [
              {
                "index": 1,
                "title": "Raffle!",
                "action_type": "post",
                "target": "https://farsight-summit-lum0x-raffle.vercel.app/api/result?initialPath=%252Fapi&previousButtonValues=%2523A_"
              }
            ],
            "input": {},
            "state": {},
            "post_url": "https://farsight-summit-lum0x-raffle.vercel.app/api?initialPath=%252Fapi&previousButtonValues=%2523A_",
            "frames_url": "https://farsight-summit-lum0x-raffle.vercel.app/api"
          }
        ],
        "channel": {
          "object": "channel_dehydrated",
          "id": "farsightsummit",
          "name": "FarSight Summit by Lum0x",
          "image_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/f19c382f-869d-49d4-2858-afc921917400/original"
        }
      }
    ],
    "next": {
      "cursor": "eyJ0aW1lc3RhbXAiOiIyMDI0LTA5LTAzIDA5OjEzOjAwLjAwMDAwMDAifQ%3D%3D"
    }
  }
}

Properties	Vaule
Object	cast
Hash	0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be
Thread Hash	0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be
Parent Hash	null
Parent URL	null
Root Parent URL	null
Parent Author	fid: null
Author	Lum0x
Author FID	721870
Author Custody Address	0x63cd09948b05e5d8367226b0c83a16b583862191
Author Username	lum0x
Author Display Name	Lum0x
Author PFP URL
Author Bio	illuminate your builder journey with Lum0x 💡\nlum0x.com
Author Follower Count	37
Author Following Count	2
Author Verifications	None
Author Verified ETH Addresses	None
Author Verified SOL Addresses	None
Author Active Status	inactive
Author Power Badge	false
Text	👀✨ Something luminous is coming to Farcaster... \n\nBuilders, are you ready to see your data in a whole new light?
Timestamp	2024-06-27T06:01:14.000Z
Embeds
Embeds Metadata	- Content Type: image/jpeg - Content Length: 169601 bytes - Image Dimensions: 800x600 px
Likes Count	1
Recasts Count	1
Likes	- zk-yuki.eth
Recasts	- ty-kindleplus
Replies Count	0
Channel	None
Mentioned Profiles	None

Field Description

• Cast Hash: The unique hash value of the cast.

• Thread Hash: The hash value of the thread containing the cast.

• Parent Hash: The hash value of the parent cast (currently none).

• Parent URL: The URL of the parent cast (currently none).

• Root Parent URL: The URL of the root parent cast (currently none).

• Parent Author: The author of the parent cast (currently none).

• Author FID: The author's unique identifier (FID).

• Custody Address: The author's wallet address.

• Username: The author's username.

• Display Name: The author's display name.

• Profile Picture URL: The URL of the author's profile picture.

• Bio: The author's introduction text.

• Follower Count: The number of followers the author has.

• Following Count: The number of people the author is following.

• Verifications: The author's verification information (currently none).

• Verified ETH Addresses: List of verified Ethereum addresses (currently none).

• Verified SOL Addresses: List of verified Solana addresses (currently none).

• Active Status: The author's activity status.

• Text: The content of the cast.

• Timestamp: The time when the cast was created.

• Embeds URL: URL of the embedded image.

• Likes Count: The number of likes on the cast.

• Recasts Count: The number of recasts of the cast.

• Likes: List of users who liked the cast.

• Recasts: List of users who recast the cast.

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

• Channel: The channel containing the cast (currently none).

• Mentioned Profiles: List of profiles mentioned in the cast (currently none).