v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Cast

Conversation for a cast

Gets all casts related to a conversation surrounding a cast by passing in a cast hash or Farcaster URL. Includes all the ancestors of a cast up to the root parent in a chronological order. Includes all direct_replies to the cast up to the reply_depth specified in the query parameter.

get/v2/farcaster/cast/conversation/

Query parameters

identifierstring required

Example:https://warpcast.com/rish/0x9288c1

Cast identifier (It's either a URL or a hash)

type'url' | 'hash' required

Example:url

The query param accepted by the API. Sent along with identifier param. url - Cast identifier is a url hash - Cast identifier is a hash

reply_depthinteger

The depth of replies in the conversation that will be returned (default 2)

include_chronological_parent_castsboolean

Include all parent casts in chronological order

viewer_fidinteger

Providing this will return a conversation that respects this user's mutes and blocks and includes viewer_context.

sort_type'chron' | 'desc_chron' | 'algorithmic'

Example:chron

Sort type for the ordering of descendants. Default is chron

fold'above' | 'below'

Show conversation above or below the fold. Lower quality responses are hidden below the fold. Not passing in a value shows the full conversation without any folding.

limitinteger

Example:30

Number of results to fetch

cursorstring

Pagination cursor.

Headers

x-neynar-experimentalboolean

Enables experimental features including filtering based on the Neynar score. See docs for more details.

Response

Success