Skip to content

Casts API

Used to retrieve valid casts or tombstones for deleted casts

API

Method NameRequest TypeResponse TypeDescription
GetCastCastIdMessageReturns a specific Cast
GetCastsByFidFidRequestMessagesResponseReturns CastAdds for an Fid in reverse chron order
GetCastsByParentCastsByParentRequestMessagesResponseReturns CastAdd replies to a given Cast in reverse chron order
GetCastsByMentionFidRequestMessagesResponseReturns CastAdds that mention an Fid in reverse chron order
GetAllCastMessagesByFidFidTimestampRequestMessagesResponseReturns Casts for an Fid with optional timestamp filtering

CastsByParentRequest

FieldTypeLabelDescription
parent_cast_idCastIdParent cast ID to find replies for (optional)
parent_urlstringParent URL to find replies for (optional)
page_sizeuint32optionalNumber of results to return per page
page_tokenbytesoptionalToken for pagination
reversebooloptionalWhether to return results in reverse order

FidTimestampRequest

FieldTypeLabelDescription
fiduint64Farcaster ID
page_sizeuint32optionalNumber of results to return per page
page_tokenbytesoptionalToken for pagination
reversebooloptionalWhether to return results in reverse order
start_timestampuint64optionalOptional timestamp to start filtering from
stop_timestampuint64optionalOptional timestamp to stop filtering at