👍Farcaster Likes

Learn how to use the Airstack API to fetch Farcaster likes reaction either from a certain user or a specific cast hash.

Table Of Contents

In this guide, you will learn to use Airstack to:

• Get All Casts Liked By A User

• Get All Casts Liked By A User In A Certain Channel

• Get All Users That Like A Certain Cast

• Get All Users That Likes Any Casts That Contains A Certain Farcaster Frames

• Check If A User Like A Certain Cast

• Check If A User Liked Any Cast In A Channel

Pre-requisites

• An Airstack account

• Basic knowledge of GraphQL

Get Started

JavaScript/TypeScript/Python

If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:

npm

React

npm install @airstack/airstack-react

Node

npm install @airstack/node

yarn

React

yarn add @airstack/airstack-react

Node

yarn add @airstack/node

pnpm

React

pnpm install @airstack/airstack-react

Node

pnpm install @airstack/node

pip

pip install airstack

Then, add the following snippets to your code:

React

import { init, useQuery } from "@airstack/airstack-react";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const Component = () => {
  const { data, loading, error } = useQuery(query);

  if (data) {
    return <p>Data: {JSON.stringify(data)}</p>;
  }

  if (loading) {
    return <p>Loading...</p>;
  }

  if (error) {
    return <p>Error: {error.message}</p>;
  }
};

Node

import { init, fetchQuery } from "@airstack/node";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const { data, error } = await fetchQuery(query);

console.log("data:", data);
console.log("error:", error);

Python

import asyncio
from airstack.execute_query import AirstackClient

api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")

query = """YOUR_QUERY""" # Replace with GraphQL Query

async def main():
    execute_query_client = api_client.create_execute_query_object(
        query=query)

    query_response = await execute_query_client.execute_query()
    print(query_response.data)

asyncio.run(main())

Other Programming Languages

To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.

Get All Casts Liked By A User

You can use the FarcasterReactions API to get all the casts liked by a user by providing the user's identity to reactedBy input filter:

Try Demo

https://app.airstack.xyz/query/NbGtNTKIIt

Show me all likes from FID 602

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        reactedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reaction {
      cast {
        castedAtTimestamp
        embeds
        url
        text
        numberOfRecasts
        numberOfLikes
        channel {
          channelId
        }
        mentions {
          fid
          position
        }
      }
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "cast": {
            "castedAtTimestamp": "2024-05-05T04:28:38Z",
            "embeds": [
              {
                "castId": {
                  "fid": 7960,
                  "hash": "0xf5dd28030a12288d0bf7b9230357269c8228a380"
                }
              }
            ],
            "url": "https://warpcast.com/marissaposner/0xf811805d",
            "text": "Proud of my cofounder @sheldon for helping drive the narrative on how layer 3s are a new way to drive value to ecosystems 🥰⬆️\n\nI’m very bullish on L3s for custom use cases (like gaming) and community-based projects. Do you think most L3s will merge together or will there be a rise of separate chains?",
            "numberOfRecasts": 0,
            "numberOfLikes": 17,
            "channel": {
              "channelId": "farcon"
            },
            "mentions": [
              {
                "fid": "7960",
                "position": 22
              }
            ]
          }
        },
        // Other likes from FID 602
      ]
    }
  }
}

Get All Casts Liked By A User In A Certain Channel

You can use the FarcasterReactions API to get all the casts liked by a user in a certain channel by providing the user's identity to reactedBy and the channel ID to channelId input filter:

Try Demo

https://app.airstack.xyz/query/3Kr9BBlb1b

Show me all the cast in /airstack channel liked by FID 602

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        channelId: {_eq: "airstack"},
        reactedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reaction {
      castHash
      cast {
        text
      }
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "castHash": "0xfb749f083fce747d0c72881dd71fda1c77176bc4",
          "cast": {
            "text": "⛴️⛴️⛴️⛴️ 🚨"
          }
        },
        // Other casts like by FID 602 in /airstack channel
      ]
    }
  }
}

Get All Users That Like A Certain Cast

You can use the FarcasterReactions APi to get all the users that liked a cast by providing the cast hash to castHash input filter:

Try Demo

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        castHash: {_eq: "0xfc328b9ba0a18fa271c508f9b91b0b66f23062fe"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reaction {
      reactedBy {
        profileName
        fid: userId
      }
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "reactedBy": {
            "profileName": "phil",
            "fid": "129"
          }
        },
        // Other user like the cast
      ]
    }
  }
}

Get All Users That Likes Any Casts That Contains A Certain Farcaster Frames

You can use FarcasterReactions API to fetch all users that likes all casts that contains a certain Frames by providing the Frames URL to the frameUrl input filter:

Try Demo

https://app.airstack.xyz/query/4Wld2IPY8F

Show me all users that likes any casts with Frames URL https://gallery.manifold.xyz/venicebreeze

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        frameUrl: {_eq: "https://gallery.manifold.xyz/venicebreeze"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reaction {
      reactedBy {
        profileName
        fid: userId
      }
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "reactedBy": {
            "profileName": "matthewbian",
            "fid": "461708"
          }
        },
        // Other users that likes
      ]
    }
  }
}

Check If A User Like A Certain Cast

You can use the FarcasterReactions APi to check if a user like a certain cast by providing the cast hash to castHash and the user's identity to the reactedBy input filter:

Try Demo

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        castHash: {_eq: "0xfc328b9ba0a18fa271c508f9b91b0b66f23062fe"},
        reactedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL
    }
  ) {
    Reaction {
      castHash
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          // if not null, then user liked the cast
          "castHash": "0xfc328b9ba0a18fa271c508f9b91b0b66f23062fe"
        }
      ]
    }
  }
}

Check If A User Liked Any Cast In A Channel

You can use the FarcasterReactions APi to check if a user like any cast in a certain channel by providing the channel ID to channelID and the user's identity to the reactedBy input filter:

Try Demo

Code

Query

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: liked,
        channelId: {_eq: "airstack"},
        reactedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL,
      limit: 1
    }
  ) {
    Reaction {
      castHash
    }
  }
}

Response

{
  "data": {
    "FarcasterReactions": {
      // If not `null`, then the user liked one of the cast in /airstack channel
      "Reaction": [
        {
          "castHash": "0xfb749f083fce747d0c72881dd71fda1c77176bc4"
        }
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching Farcaster likes data, please join our Airstack's Telegram group.

More Resources

• FarcasterReactions API Reference

• Farcaster Frames Guides