🔂Farcaster Replies

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

PreviousFarcaster Casts NextFarcaster Recasts

Last updated 8 months ago

Was this helpful?

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

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:

React

npm install @airstack/airstack-react

Node

npm install @airstack/node

React

yarn add @airstack/airstack-react

Node

yarn add @airstack/node

React

pnpm install @airstack/airstack-react

Node

pnpm install @airstack/node

pip install airstack

Then, add the following snippets to your code:

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>;
  }
};

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);

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 Replies By A Farcaster User

You can use FarcasterReplies API to fetch all the replies casted by a given Farcaster user by specifying the user's identity in repliedBy input filter:

Try Demo

Code

query MyQuery {
  FarcasterReplies(
    input: {
      filter: {
        repliedBy: {_eq: "fc_fid:602"} # specify FID 602
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reply {
      castedAtTimestamp
      embeds
      url
      text
      numberOfRecasts
      numberOfLikes
      channel {
        channelId
      }
      mentions {
        fid
        position
      }
    }
  }
}

{
  "data": {
    "FarcasterReplies": {
      "Reply": [
        {
          "castedAtTimestamp": "2024-05-06T16:30:01Z",
          "embeds": [],
          "url": "https://warpcast.com/betashop.eth/0xde71bb21",
          "text": "more thinking on this \n\nPreferred widgets/Actions at user and channel level \n\nallow more shopify-type experiences to emerge— always on my page \n\nAllows meme coins and nft projects to always have perm buy and mint actions \n\nAllows users to easily play favorite games together",
          "numberOfRecasts": 0,
          "numberOfLikes": 0,
          "channel": null,
          "mentions": []
        },
      ]
    }
  }
}

Get Farcaster Reply Details By Reply Cast Hash

You can use FarcasterReplies API to fetch a Farcaster reply details of a given Farcaster reply cast hash by specifying the reply cast in hash input filter:

If the cast is a root cast and not a reply, then you should use this query here.

Try Demo

Code

query MyQuery {
  FarcasterReplies(
    input: {
      filter: {
        # specify the reply cast hash
        hash: {_eq: "0x20c4102f0cbcb6175af1d08005be0158f54977d7"}
      },
      blockchain: ALL
    }
  ) {
    Reply {
      castedAtTimestamp
      embeds
      url
      text
      numberOfRecasts
      numberOfLikes
      channel {
        channelId
      }
      mentions {
        fid
        position
      }
    }
  }
}

{
  "data": {
    "FarcasterReplies": {
      "Reply": [
        {
          "castedAtTimestamp": "2024-05-30T11:51:24Z",
          "embeds": [],
          "url": "https://warpcast.com/hihit/0x20c4102f",
          "text": "Neat piece! 🌈",
          "numberOfRecasts": 0,
          "numberOfLikes": 0,
          "channel": null,
          "mentions": []
        }
      ]
    }
  }
}

Get All Casts Replied By A User In A Certain Channel

You can use the FarcasterReactions API to get all the casts replied 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

Code

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

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "castHash": "0xf8c7f6c0fea967f335287348d264b5e29a1b4d0c",
          "cast": {
            "text": "is there a way to rank channels by median SCV score of casts in channel (say in the past week)? by 20th or 80th percentile SCV score?\n\nin full disclosure, I am most interested to compare perceived /spanish /japanese /korean channel conversation qualities under this metric"
          }
        },
        // Other casts replied by FID 602 in /airstack channel
      ]
    }
  }
}

Get All Replies Of A Certain Cast By Cast Hash

You can use FarcasterReplies API to fetch all replies of a given cast by specifying the cast hash in parentHash input filter:

Try Demo

Code

query MyQuery {
  FarcasterReplies(
    input: {
      filter: {
        parentHash: {_eq: "0x4c0f2172836b14a57d35f5d096ced49049b1d92d"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reply {
      fid
      castedAtTimestamp
      embeds
      url
      text
      numberOfRecasts
      numberOfLikes
      channel {
        channelId
      }
      mentions {
        fid
        position
      }
    }
  }
}

{
  "data": {
    "FarcasterReplies": {
      "Reply": [
        {
          "fid": "274034",
          "castedAtTimestamp": "2024-05-06T14:25:37Z",
          "embeds": [],
          "url": "https://warpcast.com/spd/0x3d913531",
          "text": "Minted",
          "numberOfRecasts": 0,
          "numberOfLikes": 0,
          "channel": {
            "channelId": "farcards"
          },
          "mentions": []
        },
        // Other replies for cast hash 0x4c0f2172836b14a57d35f5d096ced49049b1d92d
      ]
    }
  }
}

Get All Replies From A Cast Casted By A Farcaster User

You can use FarcasterReplies API to fetch all the replies from any casts casted by a given Farcaster user by specifying the user's identity in parentCastedBy input filter:

Try Demo

Code

query MyQuery {
  FarcasterReplies(
    input: {
      filter: {
        parentCastedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reply {
      fid
      castedAtTimestamp
      embeds
      url
      text
      numberOfRecasts
      numberOfLikes
      channel {
        channelId
      }
      mentions {
        fid
        position
      }
    }
  }
}

{
  "data": {
    "FarcasterReplies": {
      "Reply": [
        {
          "fid": "8439",
          "castedAtTimestamp": "2024-05-06T12:58:56Z",
          "embeds": [],
          "url": "https://warpcast.com/sreenath/0x9f281b82",
          "text": "💯",
          "numberOfRecasts": 0,
          "numberOfLikes": 0,
          "channel": null,
          "mentions": []
        },
      ]
    }
  }
}

Get All Replies From All Casts That Contains Certain Farcaster Frames

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

Try Demo

Code

query MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: replied,
        frameUrl: {_eq: "https://gallery.manifold.xyz/venicebreeze"}
      },
      blockchain: ALL,
      limit: 200
    }
  ) {
    Reaction {
      cast {
        castedAtTimestamp
        embeds
        url
        text
        numberOfRecasts
        numberOfLikes
        channel {
          channelId
        }
        mentions {
          fid
          position
        }
      }
    }
  }
}

{{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "cast": {
            "castedAtTimestamp": "2024-05-06T17:32:10Z",
            "embeds": [
              {
                "url": "https://cdn.botfrens.com/contents/2731379/web_md.jpg"
              },
              {
                "url": "https://gallery.manifold.xyz/venicebreeze"
              }
            ],
            "url": "https://warpcast.com/carlos28355/0xf10f3c56",
            "text": "☀️ Venice Breeze 📻\r\n1/1\r\nMinted & listed with Manifold  ",
            "numberOfRecasts": 5,
            "numberOfLikes": 17,
            "channel": {
              "channelId": "cryptoart"
            },
            "mentions": []
          }
        },
        // other replies
      ]
    }
  }
}

Check If A User Replied A Certain Cast

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

Try Demo

Code

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

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          // if not null, then user replied to this cast
          "castHash": "0xfb41e8ada70ee2da9a21023ec77469a03c4bcea9"
        }
      ]
    }
  }
}

Check If User A Replied Any Cast By User B

You can use FarcasterReplies API to check if user A replied to any cast by user B:

Try Demo

Code

query MyQuery {
  FarcasterReplies(
    input: {
      filter: {
        repliedBy: {_eq: "fc_fid:2602"}, # user A
        parentCastedBy: {_eq: "fc_fid:602"} # user B
      },
      blockchain: ALL,
      limit: 1
    }
  ) {
    Reply {
      castedAtTimestamp
    }
  }
}

{
  "data": {
    "FarcasterReplies": {
      "Reply": [
        {
          // if not null, then user A replied to a cast by user B
          "castedAtTimestamp": "2024-05-05T20:48:08Z"
        }
      ]
    }
  }
}

Check If A User Replied Any Cast In A Channel

You can use the FarcasterReactions APi to check if a user replied 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 MyQuery {
  FarcasterReactions(
    input: {
      filter: {
        criteria: replied,
        channelId: {_eq: "airstack"},
        reactedBy: {_eq: "fc_fid:602"}
      },
      blockchain: ALL,
      limit: 1
    }
  ) {
    Reaction {
      castHash
    }
  }
}

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

Developer Support

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

🔂Farcaster Replies

Table Of Contents

Pre-requisites

Get Started

Get All Replies By A Farcaster User

Try Demo

Code

Get Farcaster Reply Details By Reply Cast Hash

Try Demo

Code

Get All Casts Replied By A User In A Certain Channel

Try Demo

Code

Get All Replies Of A Certain Cast By Cast Hash

Try Demo

Code

Get All Replies From A Cast Casted By A Farcaster User

Try Demo

Code

Get All Replies From All Casts That Contains Certain Farcaster Frames

Try Demo

Code

Check If A User Replied A Certain Cast

Try Demo

Code

Check If User A Replied Any Cast By User B

Try Demo

Code

Check If A User Replied Any Cast In A Channel

Try Demo

Code

Developer Support

More Resources