🔂Farcaster Replies

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

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 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"
        }
      ]
    }
  }
}

Developer Support

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

More Resources

PreviousFarcaster Casts NextFarcaster Recasts

Last updated 5 days ago

Was this helpful?

Airstack Developer Docs & FAQs

🔂Farcaster Replies

Table Of Contents

Pre-requisites

Get Started

Get All Replies By A Farcaster User

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

Developer Support

More Resources