Reactions #

Reactions are likes and recasts. Hypersnap indexes both directions — "who reacted to this cast" and "what has this user reacted to".

Common response shape:

{
  "reactions": [
    {
      "reaction_type": "like",
      "user": { /* User */ },
      "cast":  { /* Cast */ },
      "timestamp": 1712345678
    }
  ],
  "next": { "cursor": "..." }
}

---

GET /v2/farcaster/reaction #

Generic reaction lookup. If hash is provided, acts like /reaction/cast (reactions targeting the cast). Otherwise acts like /reaction/user (reactions made by fid).

Query parameters

Name	Type	Required	Notes
hash	string	conditional	If provided, switches to cast mode.
types	"likes" | "recasts"	no	For cast mode. Default "likes".
type	"likes" | "recasts"	no	For user mode. Default "likes".
fid	u64	conditional	Required in user mode.
limit	usize	no	Default 10.

---

GET /v2/farcaster/reaction/cast #

Who has reacted to a specific cast. Also reachable as GET /v2/farcaster/reactions/cast (spec-compat plural).

Query parameters

Name	Type	Required	Notes
hash	string	yes	0x-prefixed cast hash.
types	"likes" | "recasts"	no	Default "likes".
fid	u64	no	If the cast hash is ambiguous, narrows to a specific author.
limit	usize	no	Default 10.

---

GET /v2/farcaster/reaction/user #

What a specific user has liked or recasted. Also reachable as GET /v2/farcaster/reactions/user (spec-compat plural).

Query parameters

Name	Type	Required	Notes
fid	u64	yes	The reactor.
type	"likes" | "recasts"	no	Default "likes".
limit	usize	no

Write endpoints #

POST /v2/farcaster/reaction and DELETE /v2/farcaster/reaction are registered but return 501 Not Implemented. Submit signed ReactionAdd/ReactionRemove messages via the gRPC SubmitMessage endpoint.