castById
Get a cast by its FID and Hash. Query Parameters| Parameter | Description | Example |
|---|---|---|
| fid | The FID of the cast’s creator | fid=6833 |
| hash | The cast’s hash | hash=0xa48dd46161d8e57725f5e26e34ec19c13ff7f3b9 |
curl http://127.0.0.1:3381/v1/castById?fid=2&hash=0xd2b1ddc6c88e865a33cb1a565e0058d757042974
{
"data": {
"type": "MESSAGE_TYPE_CAST_ADD",
"fid": 2,
"timestamp": 48994466,
"network": "FARCASTER_NETWORK_MAINNET",
"castAddBody": {
"embedsDeprecated": [],
"mentions": [],
"parentCastId": {
"fid": 226,
"hash": "0xa48dd46161d8e57725f5e26e34ec19c13ff7f3b9"
},
"text": "Cast Text",
"mentionsPositions": [],
"embeds": []
}
},
"hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "3msLXzxB4eEYe...dHrY1vkxcPAA==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x78ff9a...58c"
}
castsByFid
Fetch all casts for authored by an FID. Query Parameters| Parameter | Description | Example |
|---|---|---|
| fid | The FID of the cast’s creator | fid=6833 |
| pageSize | Optional page size (default: 1000) | pageSize=100 |
| pageToken | Optional page token for pagination | pageToken=DAEDAAAGlQ... |
| reverse | Optional reverse order flag | reverse=true |
| startTimestamp | Optional start timestamp filter | startTimestamp=1640995200 |
| stopTimestamp | Optional stop timestamp filter | stopTimestamp=1640995200 |
curl http://127.0.0.1:3381/v1/castsByFid?fid=2
{
"messages": [
{
"data": {
"type": "MESSAGE_TYPE_CAST_ADD",
"fid": 2,
"timestamp": 48994466,
"network": "FARCASTER_NETWORK_MAINNET",
"castAddBody": {
"text": "Cast Text",
"mentionsPositions": [],
"embeds": []
}
},
"hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "3msLXzxB4eEYeF0Le...dHrY1vkxcPAA==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x78ff9a768cf1...2eca647b6d62558c"
}
],
"nextPageToken": ""
}
castsByParent
Fetch all casts by parent cast’s FID and Hash OR by the parent’s URL Query Parameters| Parameter | Description | Example |
|---|---|---|
| fid | The FID of the parent cast | fid=6833 |
| hash | The parent cast’s hash | hash=0xa48dd46161d8e57725f5e26e34ec19c13ff7f3b9 |
| url | The URL of the parent cast | url=chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2 |
| pageSize | Optional page size (default: 1000) | pageSize=100 |
| pageToken | Optional page token for pagination | pageToken=DAEDAAAGlQ... |
| reverse | Optional reverse order flag | reverse=true |
You can use either
?fid=...&hash=... OR ?url=... to query this endpointcurl http://127.0.0.1:3381/v1/castsByParent?fid=226&hash=0xa48dd46161d8e57725f5e26e34ec19c13ff7f3b9
{
"messages": [
{
"data": {
"type": "MESSAGE_TYPE_CAST_ADD",
"fid": 226,
"timestamp": 48989255,
"network": "FARCASTER_NETWORK_MAINNET",
"castAddBody": {
"embedsDeprecated": [],
"mentions": [],
"parentCastId": {
"fid": 226,
"hash": "0xa48dd46161d8e57725f5e26e34ec19c13ff7f3b9"
},
"text": "Cast's Text",
"mentionsPositions": [],
"embeds": []
}
},
"hash": "0x0e501b359f88dcbcddac50a8f189260a9d02ad34",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "MjKnOQCTW42K8+A...tRbJfia2JJBg==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x6f1e8758...7f04a3b500ba"
}
],
"nextPageToken": ""
}
castsByMention
Fetch all casts that mention an FID Query Parameters| Parameter | Description | Example |
|---|---|---|
| fid | The FID that is mentioned in a cast | fid=6833 |
| pageSize | Optional page size (default: 1000) | pageSize=100 |
| pageToken | Optional page token for pagination | pageToken=DAEDAAAGlQ... |
| reverse | Optional reverse order flag | reverse=true |
Use the
mentionsPositions to extract the offset in the cast text where the FID was mentionedcurl http://127.0.0.1:3381/v1/castsByMention?fid=6833
{
"messages": [
{
"data": {
"type": "MESSAGE_TYPE_CAST_ADD",
"fid": 2,
"timestamp": 62298143,
"network": "FARCASTER_NETWORK_MAINNET",
"castAddBody": {
"embedsDeprecated": [],
"mentions": [15, 6833],
"parentCastId": {
"fid": 2,
"hash": "0xd5540928cd3daf2758e501a61663427e41dcc09a"
},
"text": "cc and ",
"mentionsPositions": [3, 8],
"embeds": []
}
},
"hash": "0xc6d4607835197a8ee225e9218d41e38aafb12076",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "TOaWrSTmz+cyzPMFGvF...OeUznB0Ag==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x78ff9a768c...647b6d62558c"
}
],
"nextPageToken": ""
}