GET
/
v1
/
castsByParent
curl --request GET \
  --url https://hub-api.neynar.com/v1/castsByParent \
  --header 'x-api-key: <api-key>'
{
  "messages": [
    {
      "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
      "hashScheme": "HASH_SCHEME_BLAKE3",
      "signature": "aSDinaTvuI8gbWludGxpZnk=",
      "signatureScheme": "SIGNATURE_SCHEME_ED25519",
      "signer": "<string>",
      "data": {
        "type": "MESSAGE_TYPE_CAST_ADD",
        "fid": 2,
        "timestamp": 48994466,
        "network": "FARCASTER_NETWORK_MAINNET",
        "castAddBody": {
          "embedsDeprecated": [
            "<string>"
          ],
          "mentions": [
            2
          ],
          "parentCastId": {
            "fid": 2,
            "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
          },
          "parentUrl": "chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2",
          "text": "<string>",
          "mentionsPositions": [
            123
          ],
          "embeds": [
            {
              "castId": {
                "fid": 2,
                "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
              }
            }
          ]
        }
      }
    }
  ],
  "nextPageToken": "AuzO1V0DtaItCwwa10X6YsfStlynsGWT"
}

Authorizations

​
x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

​
fid
integer

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.

Required range: x >= 1
Example:

194

​
hash
string

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.

Example:

"0x776593353e47dc4e7f4df3199a9b04cc8efa30d9"

​
url
string

Cast URL starting with 'chain://'

Example:

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

​
pageSize
integer

Maximum number of messages to return in a single response

​
reverse
boolean

Reverse the sort order, returning latest messages first

​
pageToken
string

The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page

Response

200
application/json

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

The response is of type object.