--- title: Recommender API description: Build custom recommendation experiences with Luigi's Box recommender endpoints. slug: recommendations/api docKind: hub hub: recommendations --- Use the Recommender API when you want to control the markup, placement logic, or delivery flow yourself. Start with the main recommender endpoint, then expand into offline publishing and customization APIs as needed. ## Endpoints

Recommender API

Fetch recommendation results directly for custom widgets and backend-driven experiences.

Train Data Import

Import training data to improve recommender quality and cold-start performance.

Batch Publisher

Generate recommendations offline for use cases such as newsletters and batch exports.

Customizations API

Pin, block, and adjust recommendation behavior with explicit customization rules.

## Quickstarts

Build custom recommendations

Render your own recommendation UI and wire the required analytics events.

## Guides

Choose models

Start by matching business goals and page context to the right recommendation models.

Basic concepts

Understand batching, personalization, and the request structure behind the API.

Reference models

Review the standard models and how they behave in different recommendation placements.