Neynar Documentation

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

On cast

cURL

curl --request GET \
  --url 'https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like' \
  --header 'x-api-key: NEYNAR_API_DOCS'

import requests

url = "https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like"

headers = {"x-api-key": "NEYNAR_API_DOCS"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': 'NEYNAR_API_DOCS'}};

fetch('https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [\
  CURLOPT_URL => "https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like",\
  CURLOPT_RETURNTRANSFER => true,\
  CURLOPT_ENCODING => "",\
  CURLOPT_MAXREDIRS => 10,\
  CURLOPT_TIMEOUT => 30,\
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\
  CURLOPT_CUSTOMREQUEST => "GET",\
  CURLOPT_HTTPHEADER => [\
    "x-api-key: NEYNAR_API_DOCS"\
  ],\
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {

url := "https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-api-key", "NEYNAR_API_DOCS")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))
}

HttpResponse<String> response = Unirest.get("https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like")
  .header("x-api-key", "NEYNAR_API_DOCS")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://snapchain-api.neynar.com/v1/reactionsByCast?reaction_type=Like")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = 'NEYNAR_API_DOCS'

response = http.request(request)
puts response.read_body

Response

200

default

{
  "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"
}

{
  "errCode": "<string>",
  "presentable": true,
  "name": "<string>",
  "code": 123,
  "details": "<string>",
  "metadata": {
    "errcode": [\
      "<string>"\
    ]
  }
}

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. Farcaster ID (FID). A unique identifier assigned to each user in the Farcaster network. This number is permanent and cannot be changed. FIDs are assigned sequentially when users register on the network. 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. Pattern: ^0x[0-9a-fA-F]{40}$

Example:

"0xfec8fd3546e1f46cf5ad10a4ff9f5d53a3bbe9be"

reaction_type
enum
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"

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.