On cast

get

https://hub-api.neynar.com/v1/reactionsByCast

Retrieve all reactions (likes or recasts) on a specific cast in the Farcaster network. The cast is identified by its creator's FID and unique hash. This endpoint helps track engagement metrics and user interactions with specific content.

Query Params

target_fid

uint64

required

≥ 1

The FID of the cast's creator. Required to uniquely identify the cast that received the reactions. Must be used in conjunction with target_hash.

target_hash

string

required

The unique hash identifier of the cast that received the reactions. This is a 40-character hexadecimal string prefixed with '0x' that uniquely identifies the cast within the creator's posts. Must be used with target_fid.

reaction_type

string

enum

required

Defaults to Like

Type of interaction a user can have with content on the Farcaster network.

Like: Express appreciation for the target content. Similar to "likes" or "favorites" on other platforms.
Recast: Share the target content with the user's followers, similar to a "retweet" or "reblog". Helps increase content visibility.

Allowed:

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

Responses

200The requested Reactions.

defaultAn unexpected error response.