v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Feed

By filters

Fetch casts based on filters. Ensure setting the correct parameters based on the feed_type and filter_type.

get/v2/farcaster/feed/

Query parameters

feed_type'following' | 'filter'
Example:filter

Defaults to following (requires FID or address). If set to filter (requires filter_type)

filter_type'fids' | 'parent_url' | 'channel_id' | 'embed_url' | 'embed_types' | 'global_trending'
Example:fids

Used when feed_type=filter. Options include fids (requires fids), parent_url (requires parent_url), channel_id (requires channel_id), embed_url (requires embed_url), embed_types (requires embed_types), or global_trending.

fidinteger

(Optional) FID of user whose feed you want to create. By default, the API expects this field, except if you pass a filter_type

fidsstring
Example:3,2,194

Used when filter_type=FIDs . Create a feed based on a list of FIDs. Max array size is 100. Requires feed_type and filter_type.

parent_urlstring
Example:chain://eip155:1/erc721:0xd4498134211baad5846ce70ce04e7c4da78931cc

Used when filter_type=parent_url can be used to fetch content under any parent url e.g. FIP-2 channels on Warpcast. Requires feed_type and filter_type.

channel_idstring
Example:neynar

Used when filter_type=channel_id can be used to fetch casts under a channel. Requires feed_type and filter_type.

members_onlyboolean
Example:true

Used when filter_type=channel_id. Only include casts from members of the channel. True by default.

embed_urlstring
Example:https://example.com

Used when filter_type=embed_url. Casts with embedded URLs prefixed by this embed_url param will be returned. We normalize your given URL prefix and prepend 'https://' if no protocol is included. Requires feed_type and filter_type.

embed_typesstring[]

Used when filter_type=embed_types can be used to fetch all casts with matching content types. Requires feed_type and filter_type.

with_recastsboolean

Include recasts in the response, true by default

limitinteger
Example:30

Number of results to fetch

cursorstring

Pagination cursor.

viewer_fidinteger
Example:3

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

Headers

x-neynar-experimentalboolean

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

Response

Success