Overview
Top Curated Recommendations allow you to display relevant product suggestions for shoppers without requiring a specific product as a starting point. This makes them ideal for entry points such as homepages, landing pages, or “Recommended for you” sections, where a clear product context does not yet exist.
The same API call works for all shoppers. For new or anonymous users, it returns generally relevant top products, such as curated bestsellers. As soon as shopper behavior or profile data becomes available, the recommendations automatically adapt and become personalized—without any additional configuration on your side.
Top recommendations on a shop homepage
Benefits
Works Without Product Context: Display relevant recommendations even when no product has been viewed or selected.
Automatic Personalization: As soon as shopper behavior or preferences are available, recommendations adjust automatically.
Safe Fallback for New Shoppers: Ensures meaningful product suggestions for first-time or anonymous visitors.
Consistent API Usage: You always use the same endpoint; no special handling or logic is required.
Flexible Placement: Suitable for homepages, landing pages, category overviews, and dedicated recommendation sections.
Integration
Top Curated Recommendations are implemented via a single API endpoint.
A typical integration flow includes:
Ensure the basics are in place: Provide your product feed, complete product labeling, and enable the recommendation model.
Call the Top Curated endpoint: Request recommendations without passing any product IDs.
Let the system adapt automatically:
For shoppers with no interactions, the API returns broadly relevant top products.
For shoppers with existing behavior or profile data, recommendations become personalized.
Render recommendations on the page: Display the returned product list in your chosen layout.
No conditional logic or separate endpoints are required—the system automatically determines the most appropriate recommendations based on available shopper data.
To implement this use case, see Using Curated Recommendations for an overview of available methods and example requests.
For full parameter details, refer to the API documentation.