GET
/
v1
/
reactionsByCast
curl --request GET \
  --url https://hub-api.neynar.com/v1/reactionsByCast \
  --header 'x-api-key: <api-key>'
{
  "messages": [
    {
      "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
      "hashScheme": "HASH_SCHEME_BLAKE3",
      "signature": "aSDinaTvuI8gbWludGxpZnk=",
      "signatureScheme": "SIGNATURE_SCHEME_ED25519",
      "signer": "<string>",
      "data": {
        "type": "MESSAGE_TYPE_CAST_ADD",
        "fid": 2,
        "timestamp": 48994466,
        "network": "FARCASTER_NETWORK_MAINNET",
        "reactionBody": {
          "type": "REACTION_TYPE_LIKE",
          "targetCastId": {
            "fid": 2,
            "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
          },
          "targetUrl": "https://www.example.com/article"
        }
      }
    }
  ],
  "nextPageToken": "AuzO1V0DtaItCwwa10X6YsfStlynsGWT"
}

Authorizations

​
x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

​
target_fid
integer
required

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.

Required range: x >= 1
Example:

1

​
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.

Example:

"0xfec8fd3546e1f46cf5ad10a4ff9f5d53a3bbe9be"

​
reaction_type
enum<string>
default:REACTION_TYPE_LIKE
required

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.
Available options:
REACTION_TYPE_LIKE,
REACTION_TYPE_RECAST
Example:

"REACTION_TYPE_LIKE"

​
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
The requested Reactions.

The response is of type object.