Feeds #

Feed endpoints return ordered lists of casts. Shape is always:

{ "casts": [ { /* Cast */ } ], "next": { "cursor": "..." } }

See Pagination & cursors for how to walk large result sets.

---

GET /v2/farcaster/feed #

Generic feed endpoint. Behavior depends on feed_type.

Query parameters

Name	Type	Required	Notes
feed_type	string	no	"following" (default), "trending", or a future feed type.
fid	u64	conditional	Required when feed_type="following" — whose feed to render.
limit	usize	no	Default 10.
cursor	string	no	Pagination cursor.

---

GET /v2/farcaster/feed/following #

Explicit alias of /feed?feed_type=following.

Query parameters

Name	Type	Required
fid	u64	yes
limit	usize	no
cursor	string	no

Semantics — casts authored by users fid follows, ordered newest-first.

---

GET /v2/farcaster/feed/trending #

Network-wide trending casts, ranked by an engagement heuristic over a rolling window.

Query parameters

Name	Type	Required
limit	usize	no
cursor	string	no

---

GET /v2/farcaster/feed/channels #

Feed of casts parented to one or more channels (either by channel id or by parent URL).

Query parameters

Name	Type	Required	Notes
channel_ids	string	yes	Comma-separated channel ids or channel parent URLs.

Example

curl -s "https://haatz.quilibrium.com/v2/farcaster/feed/channels?channel_ids=memes,base,dev"

---

GET /v2/farcaster/feed/parent_urls #

Feed of casts with a matching parent_url. Useful when you have raw parent URLs (not yet resolved to a channel id).

Query parameters

Name	Type	Required	Notes
parent_urls	string	yes	Comma-separated parent URLs.
limit	usize	no
cursor	string	no

---

GET /v2/farcaster/feed/for_you #

Personalized "For You" feed. Personalization requires model inference which isn't available on-node, so this endpoint currently returns the trending feed. Registered for SDK compatibility.

Query parameters

Name	Type	Required
limit	usize	no
cursor	string	no

---

GET /v2/farcaster/feed/topic #

Feed filtered by topic slug. No on-node hashtag/topic indexing exists, so this endpoint currently returns the trending feed. Registered for SDK compatibility.

---

GET /v2/farcaster/feed/user/casts #

User's casts in reverse chronological order. Each cast is enriched with engagement metrics (likes, recasts, replies counts) from the MetricsIndexer.

Query parameters

Name	Type	Required
fid	u64	yes
limit	usize	no
cursor	string	no

---

GET /v2/farcaster/feed/user/popular #

A user's top 10 casts by engagement score (likes + recasts + replies), computed from the local MetricsIndexer.

Query parameters

Name	Type	Required
fid	u64	yes
limit	usize	no

---

GET /v2/farcaster/feed/user/replies_and_recasts #

A user's casts filtered to only replies (casts with a parent field).

Query parameters

Name	Type	Required
fid	u64	yes
limit	usize	no
cursor	string	no