🌀Farcaster Recasts

Learn how to use the Airstack API to fetch Farcaster recasts and quoted recasts 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 Recasts By A Farcaster User

You can use FarcasterReactions API to fetch all recasts by a Farcaster user by specifying the user's identity in reactedBy input filter:

If you are looking for quoted recasts, check this query instead.

Try Demo

Code

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

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "cast": {
            "castedAtTimestamp": "2024-05-06T00:03:43Z",
            "embeds": [
              {
                "url": "https://farcaster.network"
              }
            ],
            "url": "https://warpcast.com/greg/0xe98b22bf",
            "text": "https://farcaster.network is back!\n\n@zachterrell and I originally built it in 2022, but it's slowly crumbled over time as Farcaster grew from a few hundred users to tens of thousands\n\nDuring Farcon, we finally took the time to rebuild it from the ground up and are excited to be working on it again",
            "numberOfRecasts": 46,
            "numberOfLikes": 254,
            "channel": {
              "channelId": "farhack"
            },
            "mentions": [
              {
                "fid": "457",
                "position": 36
              }
            ]
          }
        },
        // other recasts by FID 602
      ]
    }
  }
}

Get All Quoted Recasts By A Farcaster User

You can use FarcasterQuotedRecasts API to fetch all quoted recasts by a Farcaster user by specifying the user's identity in recastedBy input filter:

Try Demo

Code

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

{
  "data": {
    "FarcasterQuotedRecasts": {
      "QuotedRecast": [
        {
          "castedAtTimestamp": "2024-05-06T15:40:23Z",
          "embeds": [
            {
              "castId": {
                "fid": 602,
                "hash": "0x08796828d8bdda14fd1acbed1472c0feab1452e7"
              }
            }
          ],
          "url": "https://warpcast.com/betashop.eth/0x6da72057",
          "text": "would also be cool to have some Actions at the User level. \n\nFor example: \n- Top casts\n- Top followers (most engaged)\n- check NOTA earnings\n- check Degen\n- NFTs in common\netc\n\n@dwr.eth @v @horsefacts.eth",
          "numberOfRecasts": 2,
          "numberOfLikes": 41,
          "channel": null,
          "mentions": [
            {
              "fid": "3",
              "position": 176
            },
            {
              "fid": "2",
              "position": 177
            },
            {
              "fid": "3621",
              "position": 178
            }
          ]
        },
        // Other quote recasts by FID 602
      ]
    }
  }
}

Get All Users That Recasts A Certain Cast

You can use FarcasterReactions API to get all the users that recasted a specific cast hash by providing the cast hash into castHash input filter:

Try Demo

Code

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

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        {
          "reactedBy": {
            "profileName": "betashop.eth",
            "fid": "602"
          }
        }
      ]
    }
  }
}

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

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

Try Demo

Code

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

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

Get All Quoted Recasts From A Cast Casted By A Farcaster User

You can use FarcasterQuotedRecasts API to get all quoted recasts of any casts by a specified Farcaster user by providing the Farcaster user's identity to the parentCastedBy input filter:

Try Demo

Code

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

{
  "data": {
    "FarcasterQuotedRecasts": {
      "QuotedRecast": [
        {
          "castedAtTimestamp": "2024-05-06T16:49:14Z",
          "embeds": [
            {
              "castId": {
                "fid": 602,
                "hash": "0xd65fda9c0db0d4cd82bbb10de8de6b43a9a0c9c5"
              }
            }
          ],
          "url": "https://warpcast.com/leovido.eth/0x4d5f9045",
          "text": "I use @airstack frames analytics dashboard practically EVERYDAY\n\nThe insights help me work on key areas of the app and track actual usage and engagement.\n\nA MUST, a super PRO tool, for frames and cast action devs 🚀",
          "numberOfRecasts": 1,
          "numberOfLikes": 3,
          "channel": {
            "channelId": "frames-devs"
          },
          "mentions": [
            {
              "fid": "20909",
              "position": 6
            }
          ]
        },
        // Other quoted recasts
      ]
    }
  }
}

Check If A User Recasted A Certain Cast By Cast Hash

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

Try Demo

Code

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

{
  "data": {
    "FarcasterReactions": {
      "Reaction": [
        // if not null, then user recasted the cast
        {
          "cast": {
            "castedAtTimestamp": "2024-05-06T16:49:14Z",
            "embeds": [
              {
                "castId": {
                  "fid": 602,
                  "hash": "0xd65fda9c0db0d4cd82bbb10de8de6b43a9a0c9c5"
                }
              }
            ],
            "url": "https://warpcast.com/leovido.eth/0x4d5f9045",
            "text": "I use @airstack frames analytics dashboard practically EVERYDAY\n\nThe insights help me work on key areas of the app and track actual usage and engagement.\n\nA MUST, a super PRO tool, for frames and cast action devs 🚀",
            "numberOfRecasts": 1,
            "numberOfLikes": 3,
            "channel": {
              "channelId": "frames-devs"
            },
            "mentions": [
              {
                "fid": "20909",
                "position": 6
              }
            ]
          }
        }
      ]
    }
  }
}

Check If User A Quote Recasted A Cast By User B

You can FarcasterQuotedRecasts API to check if user A quote recasted any cast by user B:

Try Demo

Code

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

{
  "data": {
    "FarcasterQuotedRecasts": {
      "QuotedRecast": [
        {
          // if not null, then user A quoted recasts FID 602's cast
          "castedAtTimestamp": "2024-05-06T15:24:18Z"
        }
      ]
    }
  }
}

Developer Support

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

More Resources

PreviousFarcaster Replies NextFarcaster Likes

Last updated 5 days ago

Was this helpful?

Airstack Developer Docs & FAQs

🌀Farcaster Recasts

Table Of Contents

Pre-requisites

Get Started

Get All Recasts By A Farcaster User

Try Demo

Code

Get All Quoted Recasts By A Farcaster User

Try Demo

Code

Get All Users That Recasts A Certain Cast

Try Demo

Code

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

Try Demo

Code

Get All Quoted Recasts From A Cast Casted By A Farcaster User

Try Demo

Code

Check If A User Recasted A Certain Cast By Cast Hash

Try Demo

Code

Check If User A Quote Recasted A Cast By User B

Try Demo

Code

Developer Support

More Resources