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 need no product as a starting point. You request them without passing product IDs. For shoppers without interactions, the response contains broadly relevant top products, such as curated bestsellers. For shoppers with behavior or profile data, the recommendations are personalized. No conditional logic or separate requests are needed.
On basket, wishlist or checkout pages, request basket items instead. They recommend additional products based on the products in the basket.
Requirements
Mapp labels your products and enables the recommendation model during onboarding. You provide your product data and your order and return data, delegate a domain, and set up tracking with the Smart Pixel. For the complete list, see the column Top & Basket Recommendations in the Prerequisites Matrix.
Display Options
Smart Pixel retrieval: The Smart Pixel requests the recommendations, and you render them in your own frontend. See Top Items and Basket Items in Recommendation Items.
Server-side API: Your server requests the recommendations. See /v2/items/top and /v2/items/basket.
If you render recommendations yourself, set up Recommendation Tracking so that clicks are recorded. For which identifier to pass, see Product and Customer Identifiers.
For all building blocks of an integration, see the Integration Overview.