GET
/
v1
/
reactionsByTarget
curl --request GET \
  --url https://hub-api.neynar.com/v1/reactionsByTarget \
  --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

url
string
required

Target URL starting with 'chain://'.

Example:

"chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2"

reaction_type
enum<string>
default:REACTION_TYPE_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.
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.