Neynar Reactions API

Operations related to reactions.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 4 operations across 4 paths, and defines 15 schemas. It is described by OpenAPI 3.0.4, at version 3.176.0.

Requests are made against a single base URL, https://api.neynar.com.

4 operations 4 paths 15 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.0.4

API Version

3.176.0

Base URL

https://api.neynar.com

Authentication

API Key

Contact

Neynar

Resource Areas

Authentication & Security 1

Neynar Reactions API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

ApiKeyAuth — API key to authorize requests

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Reactions 4

Operations related to reactions.

GET

/v1/reactionById

By FID or cast

lookup-reaction-by-id 4 params → 200default

GET

/v1/reactionsByCast

On cast

fetch-cast-reactions 6 params → 200default

GET

/v1/reactionsByFid

By FID

fetch-user-reactions 5 params → 200default

GET

/v1/reactionsByTarget

To a target URL

fetch-reactions-by-target 5 params → 200default

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are ErrorResponse (6 properties), MessageCommon (5 properties), MessageDataCommon (4 properties), ReactionBody (3 properties). Each schema is shown below with its type and property counts.

PaginationResponse

object

1 property 1 required

FidSchema

integer

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 seque…

SignatureScheme

string

Type of signature scheme used to sign the Message hash - SIGNATURESCHEMEED25519: Ed25519 signature (default) - SIGNATURESCHEMEEIP712: ECDSA signature using EIP…

FarcasterNetwork

string

Farcaster network the message is intended for. - FARCASTERNETWORKMAINNET: Public primary network - FARCASTERNETWORKTESTNET: Public test network - FARCASTERNETW…

MessageCommon

object

5 properties 5 required

MessageType

string

Type of the MessageBody. - MESSAGETYPECASTADD: Add a new Cast - MESSAGETYPECASTREMOVE: Remove an existing Cast - MESSAGETYPEREACTIONADD: Add a Reaction to a Ca…

HashScheme

string

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

ReactionType

string

Type of interaction a user can have with content on the Farcaster network. - Like: Express appreciation for the target content. Similar to "likes" or "favorite…

CastHash

string

A unique hash that identifies a specific cast within the creator's posts. Generated using HASHSCHEMEBLAKE3 of the cast's content.

MessageDataReaction

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 c…

ErrorResponse

object

6 properties 6 required

ReactionBody

object

Specifies the details of a reaction to content on Farcaster. A reaction must specify its type (like/recast) and either a target cast ID or URL to react to. Onl…

3 properties 1 required

Reaction

MessageDataCommon

object

Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.

4 properties 3 required

CastId

object

A unique identifier for a cast (post) in the Farcaster network, consisting of the creator's FID and a hash of the cast's content. This combination ensures glob…

2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

#Reactions

← Back to N APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Neynar Reactions API

Metadata

Authentication & Security 1

Paths & Operations 4

Schemas 15

Specification

Source

API Details

Provider

Explore more