Get all reactions to a target URL

GET

reactionsByTarget

Query Parameters

url

string

required

The URL of the parent cast

reaction_type

enum<string>

default: REACTION_TYPE_LIKErequired

The type of reaction, either as a numerical enum value or string representation

Available options:

REACTION_TYPE_LIKE,

REACTION_TYPE_RECAST

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[]

required

messages.hash

string

required

messages.hashScheme

enum<string>

default: HASH_SCHEME_BLAKE3required

Type 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

required

messages.signatureScheme

enum<string>

default: SIGNATURE_SCHEME_ED25519required

Type 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

required

messages.data

object

required

messages.data.type

enum<string>

default: MESSAGE_TYPE_CAST_ADDrequired

Type 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

required

messages.data.timestamp

integer

required

messages.data.network

enum<string>

default: FARCASTER_NETWORK_MAINNETrequired

Farcaster 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.reactionBody

object

required

Adds or removes a Reaction from a Cast

nextPageToken

string

required

Get all reactions to a cast Get a link by its FID and target FID.

Get Started

Dev Tools

Farcaster API

Farcaster Auth

Frame Analytics API

Hub API Reference

Get all reactions to a target URL

Query Parameters

Response