v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Casts

By parent cast

Retrieve all reply casts (responses) to a specific parent cast in the Farcaster network. Parent casts can be identified using either a combination of FID and hash, or by their URL. This endpoint enables traversal of conversation threads and retrieval of all responses to a particular cast.

get/v1/castsByParent

Query parameters

fidinteger

Example:194

The Farcaster ID (FID) of the parent cast's creator. This parameter must be used together with the 'hash' parameter to uniquely identify a parent cast. Required only when using hash-based lookup instead of URL-based lookup. The FID is a unique identifier assigned to each Farcaster user.

hashstring

Example:0x776593353e47dc4e7f4df3199a9b04cc8efa30d9

The unique hash identifier of the parent cast. Must be used together with the 'fid' parameter when doing hash-based lookup. This is a 40-character hexadecimal string prefixed with '0x' that uniquely identifies the cast within the creator's posts. Not required if using URL-based lookup.

urlstring uri

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

Cast URL starting with 'chain://'

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

A successful response containing all reply casts to the specified parent cast, along with pagination information for traversing large result sets.

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,
        "castAddBody": {
          "mentions": [
            2
          ],
          "parentCastId": {
            "fid": 2,
            "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
          },
          "parentUrl": "chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2",
          "embeds": [
            {
              "castId": {
                "fid": 2,
                "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
              }
            }
          ]
        }
      }
    }
  ],
  "nextPageToken": "AuzO1V0DtaItCwwa10X6YsfStlynsGWT"
}