Casts
Fetch all casts authored by an FID.
- API Keys
- Blog
- Community
- Farcaster Development Kit
- Getting Started
- GETCast by Hash
- GETCasts
- POSTSend Cast
- DELDelete Cast
- POSTAdd Reaction to Cast
- DELDelete Reaction to Cast
- GETChannels List
- GETChannel By Name
- POSTFollow FID
- DELUnfollow FID
- GETUser By FID
- GETUsers
- Getting Started
- POSTSigners
- POSTRegister Signer with Warpcast
- POSTPoll Warpcast Signer
- GETGet Signers
- Info
- Casts
- Reactions
- Links
- User Data
- Username Proofs
- Verifications
- FIDs
- Storage
- Onchain API
Dev Tools
Farcaster API
Farcaster Auth
Hub API Reference
Casts
Fetch all casts authored by an FID.
GET
/
v1
/
castsByFid
fid
integer
*
fid
Required
integer
The FID of the casts' creator
pageSize
integer
pageSize
integer
Maximum number of messages to return in a single response
reverse
boolean
reverse
boolean
Reverse the sort order, returning latest messages first
pageToken
string
pageToken
string
The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page
Query Parameters
fid
integer
requiredThe FID of the casts' creator
pageSize
integer
Maximum number of messages to return in a single response
reverse
boolean
Reverse the sort order, returning latest messages first
pageToken
string
The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page
Response
200 - application/json
messages
object[]
requiredmessages.hash
string
requiredmessages.hashScheme
enum<string>
default: HASH_SCHEME_BLAKE3requiredType of hashing scheme used to produce a digest of MessageData. - HASH_SCHEME_BLAKE3: Default scheme for hashing MessageData
Available options:
HASH_SCHEME_BLAKE3 messages.signature
string
requiredmessages.signatureScheme
enum<string>
default: SIGNATURE_SCHEME_ED25519requiredType of signature scheme used to sign the Message hash
- SIGNATURE_SCHEME_ED25519: Ed25519 signature (default)
- SIGNATURE_SCHEME_EIP712: ECDSA signature using EIP-712 scheme
Available options:
SIGNATURE_SCHEME_ED25519, SIGNATURE_SCHEME_EIP712 messages.signer
string
requiredmessages.data
object
requiredmessages.data.type
enum<string>
default: MESSAGE_TYPE_CAST_ADDrequiredType of the MessageBody.
- MESSAGE_TYPE_CAST_ADD: Add a new Cast
- MESSAGE_TYPE_CAST_REMOVE: Remove an existing Cast
- MESSAGE_TYPE_REACTION_ADD: Add a Reaction to a Cast
- MESSAGE_TYPE_REACTION_REMOVE: Remove a Reaction from a Cast
- MESSAGE_TYPE_LINK_ADD: Add a new Link
- MESSAGE_TYPE_LINK_REMOVE: Remove an existing Link
- MESSAGE_TYPE_VERIFICATION_ADD_ETH_ADDRESS: Add a Verification of an Ethereum Address
- MESSAGE_TYPE_VERIFICATION_REMOVE: Remove a Verification
- MESSAGE_TYPE_USER_DATA_ADD: Deprecated MESSAGE_TYPE_SIGNER_ADD = 9; // Add a new Ed25519 key pair that signs messages for a user MESSAGE_TYPE_SIGNER_REMOVE = 10; // Remove an Ed25519 key pair that signs messages for a user
Add metadata about a user
- MESSAGE_TYPE_USERNAME_PROOF: Add or replace a username proof
Available options:
MESSAGE_TYPE_CAST_ADD, MESSAGE_TYPE_CAST_REMOVE, MESSAGE_TYPE_REACTION_ADD, MESSAGE_TYPE_REACTION_REMOVE, MESSAGE_TYPE_LINK_ADD, MESSAGE_TYPE_LINK_REMOVE, MESSAGE_TYPE_VERIFICATION_ADD_ETH_ADDRESS, MESSAGE_TYPE_VERIFICATION_REMOVE, MESSAGE_TYPE_USER_DATA_ADD, MESSAGE_TYPE_USERNAME_PROOF messages.data.fid
integer
requiredmessages.data.timestamp
integer
requiredmessages.data.network
enum<string>
default: FARCASTER_NETWORK_MAINNETrequiredFarcaster network the message is intended for.
- FARCASTER_NETWORK_MAINNET: Public primary network
- FARCASTER_NETWORK_TESTNET: Public test network
- FARCASTER_NETWORK_DEVNET: Private test network
Available options:
FARCASTER_NETWORK_MAINNET, FARCASTER_NETWORK_TESTNET, FARCASTER_NETWORK_DEVNET messages.data.castAddBody
object
requiredAdds a new Cast
messages.data.castAddBody.embedsDeprecated
string[]
requiredmessages.data.castAddBody.mentions
integer[]
requiredmessages.data.castAddBody.parentCastId
object
Identifier used to look up a Cast
messages.data.castAddBody.parentCastId.fid
integer
requiredmessages.data.castAddBody.parentCastId.hash
string
requiredmessages.data.castAddBody.parentUrl
string
messages.data.castAddBody.text
string
requiredmessages.data.castAddBody.mentionsPositions
integer[]
requiredmessages.data.castAddBody.embeds
object[]
requiredmessages.data.castAddBody.embeds.url
string
requiredmessages.data.castAddBody.embeds.castId
object
Identifier used to look up a Cast
messages.data.castAddBody.embeds.castId.fid
integer
requiredmessages.data.castAddBody.embeds.castId.hash
string
requirednextPageToken
string
required