Overview
The recommendations endpoint delivers personalized content feeds tailored to individual users. This endpoint consumes feed configurations (referenced via feed_id) to generate ranked lists of content from Farcaster posts, Zora posts, or Polymarket markets.
Key Concepts
- Feed Configuration: Pre-configured feeds created via the Feed Management API define filtering, scoring, and ranking logic
- Personalization: Recommendations are customized per user based on their interaction history, following graph, and preferences
- Feed Sources: Supports Farcaster items (posts), Zora coins (posts), and Polymarket markets
- Override Parameters: Any parameters passed directly to the API override those saved in the
feed_idconfiguration
Usage
Returns a list of recommended items (posts, Zora posts, or Polymarket markets) for a specific user - items the user is most likely to interact with. The feed_id parameter lets you use preconfigured filters and ranking logic from the console, while direct API parameters provide runtime overrides. For Polymarket feeds, use wallet_address instead of user_id.
Feed Status
Feed statuses let you trade off performance vs. cost by controlling how aggressively a feed is pre‑warmed and cached before users request it. Available statuses include Draft (for experimentation), Group (for beta testing with whitelisted users), and Live (for full production).
For complete details on feed statuses, warmup tiers, latency considerations, and cost implications, see the Feed Status Guide and Compute units to pricing mapping.