GET
/
v1
/
reactionsByTarget
To a target URL
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": "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: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:
Like,
Recast
Example:

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