Indexing Data

To use Luigi’s Box product discovery APIs, you need to synchronize your product catalog with our service. Once we have your catalog, we continuously match it with analytics data and use that feedback to improve ranking and personalization.

Luigi’s Box supports two primary catalog synchronization paths: near real-time updates through the content APIs or periodic processing through feeds. While both are supported, the content APIs are the preferred path whenever you can implement them.

Choose your integration path

Preferred path

Content Updates API

Use the indexing APIs for near real-time synchronization, partial updates, and generation-safe bulk imports.

• Best freshness and control.
• Supports full and partial updates.
• Fits modern backend integrations.

Batch sync

Feeds

Use XML, JSON, or CSV feeds when your platform already exports batch catalog files on a schedule.

• Simple to adopt when feeds already exist.
• Works with multiple structured formats.
• Good fit for periodic synchronization.

Start here

Need the shared data model first? Start with the indexing data layout quickstart.

Implementing the preferred API path? Continue with Indexing with Luigi's Box.

Implementing through exported files? Continue with the main Feeds documentation.

Core concepts

Regardless of the integration path you choose, understanding these core concepts is essential for a successful implementation.

• Data Layout: Luigi’s Box follows a “convention over configuration” approach. While you have flexibility in naming attributes, several special fields have predefined behaviors that impact search results and ranking. For example, availability is used to sort available products first, price is used for faceting and value extraction, and image_link is used by frontend components to display product images.
• Object Identity: Before indexing, it’s crucial to establish a stable, unique identity for every object (product, category, etc.). This identity is the key that links the indexed object in your catalog to the behavioral data collected through analytics events, forming the feedback loop that powers our AI-driven ranking.
• Content Export: Once your data is indexed, you can retrieve it at any time using the Content Export API. This endpoint allows you to download your entire catalog stored in Luigi’s Box for verification, backup, or other purposes. The results are paginated and the API is designed for bulk export, not real-time consumption.