Navigation
ℹ️

Infrastructure Update

Luigi's Box is updating its primary domain recommendations.

Our services are fully operational across both .com and .tech domains. To ensure the highest level of redundancy, we now recommend using the .tech domain for all integrations.

1. API Base URLs

Please update the base URLs for your specific services:

A. Search, Autocomplete, Product Listing, and Recommendations
SUPPORTED https://live.luigisbox.com
RECOMMENDED https://live.luigisbox.tech
B. Analytics
SUPPORTED https://api.luigisbox.com
RECOMMENDED https://api.luigisbox.tech

2. Frontend Script

Both script sources are valid, but we encourage updating to the .tech domain for consistency:

Supported
<script async src="https://scripts.luigisbox.com/LBX-123.js"></script>
Recommended
<script async src="https://scripts.luigisbox.tech/LBX-123.js"></script>

3. CSP & Firewalls

To support the recommended configuration, please ensure your Content Security Policy (CSP) includes the following:

script-src https://scripts.luigisbox.tech;
connect-src https://live.luigisbox.tech https://api.luigisbox.tech;

Support: [email protected] UPDATED: 01/07/2026

Recommendations overview

Luigi's Box Recommendations is a powerful system designed to increase user engagement and sales by displaying relevant products to users. It utilizes a wide range of AI-powered models trained on product catalog data and user behavior to deliver personalized and contextually appropriate suggestions. The models are trained on a per-customer basis to meet specific business goals, such as recommending complementary accessories or alternative items. Luigi's Box offers several integration paths. For a fast, frontend-focused implementation, the Recco.js library provides a complete UI component. For maximum flexibility, the Recommender API allows for deep backend integration. For offline use cases like email campaigns, the Recommendation Batch Publisher can generate recommendations for large user sets on a schedule.


Choose your integration path

Recommended

Recco.js

A frontend JavaScript library to rapidly build an interactive recommendation UI.

Custom build

Recommender API

A flexible backend endpoint to get recommendations based on popularity, similarity, and user history.

  • Fast implementation: Quickly integrate a recommender by including the script and setting configuration parameters.
  • Easy customization: Use pre-built themes or provide custom HTML templates using Vue.js syntax to match a site's branding.
  • Built-in features: Includes an optional carousel mode and a batch mode that improves performance by making a single API call for all recommenders on a page.
  • Maximum flexibility: A direct API provides full control for custom backend implementations and integration with any platform.
  • Powerful contextual filtering: Use the recommendation_context to apply request-time restrictions on results, such as filtering by brand, category, or price.
  • Performance optimization: Utilize request batching to improve latency and receive deduplicated recommendations across multiple placements on a single page.

Core Concepts

Understanding these core concepts will help you get the most out of Luigi's Box Recommendations.

  • Recommendation models: Models are the AI component that drives the recommendations. They can be content-based, using product data to find similar items, or behavioral, which observe how users interact with products (e.g., what's frequently bought together). Luigi's Box offers a wide range of standard models that are trained and customized for each client's specific business case.
  • Personalization: The recommender models are designed to consider user preferences to deliver personalized suggestions. By providing a user_id in the request, the model uses the corresponding user profile, built from analytics data, as an additional input to tailor the results.
  • Batching: When displaying several recommenders on a single page, it is highly recommended to batch all requests into a single API call. This improves performance and latency, as the user's profile is only loaded once. It also ensures that the same product is not recommended by different models on the same page through automatic deduplication.
  • Batch Publishing: In contrast to real-time recommendations, the Batch Publisher service is designed for offline scenarios that require recommendations for a large group of users at a scheduled time, such as for email newsletters. The service automatically generates personalized recommendation batches based on a schedule. A key prerequisite is tracking Customer IDs in the analytics collection process, which allows the service to generate personalized content for each user.