API Reference

By filters

get
https://api.neynar.com/v2/farcaster/feed

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

Query Params
string
enum
required
Defaults to following

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

Allowed:
string
enum

Used when feed_type=filter. Can be set to FIDs (requires FIDs) or parent_url (requires parent_url) or channel_id (requires channel_id)

Allowed:
int32

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

string

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.

string

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.

string

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

boolean
Defaults to true
deprecated

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

string

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_types
array of objects

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

embed_types
boolean
Defaults to true

Include recasts in the response, true by default

integer
1 to 100
Defaults to 25

Number of results to fetch

string

Pagination cursor.

int32

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

Headers
boolean
Defaults to false

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

Responses

Updated over 1 year ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 1 year ago