Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Reactions

To a target URL

Fetch all reactions of a specific type (like or recast) that target a given URL. This endpoint is useful for tracking engagement with content across the Farcaster network.

get/v1/reactionsByTarget

Query parameters

urlstring required
Example:chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2

Target URL starting with 'chain://'.

reaction_type'Like' | 'Recast'

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.
Example:Like
pageSizeinteger

Maximum number of messages to return in a single response

reverseboolean

Reverse the sort order, returning latest messages first

pageTokenstring

The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page

Response

The requested Reactions.

nextPageTokenstring byte required

Base64-encoded pagination token for fetching the next page of results. An empty value indicates there are no more pages to return. Used in conjunction with the pageSize parameter to implement pagination across large result sets.

Example response

{
  "messages": [
    {
      "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
      "data": {
        "fid": 2,
        "timestamp": 48994466,
        "reactionBody": {
          "type": "Like",
          "targetCastId": {
            "fid": 2,
            "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
          },
          "targetUrl": "https://www.example.com/article"
        }
      }
    }
  ],
  "nextPageToken": "AuzO1V0DtaItCwwa10X6YsfStlynsGWT"
}