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
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
Author FID
721870
Author Custody Address
0x63cd09948b05e5d8367226b0c83a16b583862191
Author Username
lum0x
Author Display Name
Lum0x
Author PFP URL
Author Bio
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
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).
Last updated