By parent cast

get https://hub-api.neynar.com/v1/castsByParent

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.

Query Params

fid

uint64

≥ 1

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.

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.

url

uri

Cast URL starting with 'chain://'

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

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url https://hub-api.neynar.com/v1/castsByParent \
3
     --header 'accept: application/json' \
4
     --header 'x-api-key: NEYNAR_API_DOCS'


xxxxxxxxxx
46
}
1
{
2
  "messages": [
3
    {
4
      "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
5
      "hashScheme": "HASH_SCHEME_BLAKE3",
6
      "signature": "string",
7
      "signatureScheme": "SIGNATURE_SCHEME_ED25519",
8
      "signer": "string",
9
      "data": {
10
        "fid": 2,
11
        "timestamp": 48994466,
12
        "network": "FARCASTER_NETWORK_MAINNET",
13
        "castAddBody": {
14
          "embedsDeprecated": [
15
            "string"
16
          ],
17
          "mentions": [
18
            0
19
          ],
20
          "parentCastId": {
21
            "fid": 2,
22
            "hash": "0x03aff391a6eb1772b20b4ead9a89f732be75fe27"
23
          },
24
          "parentUrl": "chain://eip155:1/erc721:0x39d89b649ffa044383333d297e325d42d31329b2",
25
          "text": "string",
26
          "mentionsPositions": [
27
            0
28
          ],
29
          "embeds": [

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

defaultAn unexpected error response.