GET
/
v1
/
reactionById
By FID or cast
curl --request GET \
  --url https://hub-api.neynar.com/v1/reactionById \
  --header 'x-api-key: <api-key>'
{
  "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"
    }
  }
}

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

fid
integer
required

The FID of the reaction's creator

target_fid
integer
required

The FID of the cast's creator

target_hash
string
required

The cast's hash

reaction_type
enum<string>
default: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:
Like,
Recast
Example:

"Like"

Response

The requested Reaction.

hash
string
required
Example:

"0xd2b1ddc6c88e865a33cb1a565e0058d757042974"

hashScheme
enum<string>
default:HASH_SCHEME_BLAKE3
required

Type of hashing scheme used to produce a digest of MessageData. - HASH_SCHEME_BLAKE3: Default scheme for hashing MessageData

Available options:
HASH_SCHEME_BLAKE3
signature
string<byte>
required
signatureScheme
enum<string>
default:SIGNATURE_SCHEME_ED25519
required

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
signer
string
required
data
object
required

Represents a user's reaction to content on the Farcaster network. Reactions can be likes or recasts of casts, allowing users to express appreciation or share content with their followers. Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.