---
title: Assistant API
description: Build guided product discovery flows with the Luigi's Box Shopping Assistant API.
slug: shopping-assistant/api
docKind: hub
hub: shopping-assistant
---

Use the Assistant API when you want full control over a structured question-and-answer product discovery flow. Start with the implementation guide when you are planning the flow, use the quickstart when you want a hands-on build, then use the technical reference for the exact request and response schema.

## Guides

<div class="lb-guide-grid">
  <a class="lb-guide-card" href="/shopping-assistant/guides/implementation-flow/">
    <h3>Implementation flow</h3>
    <p>Plan request state, rendering, history behavior, runtime fields, and completion handling.</p>
  </a>
  <a class="lb-guide-card" href="/shopping-assistant/guides/analytics/">
    <h3>Analytics</h3>
    <p>Connect assistant flow data to downstream product clicks, cart actions, and conversion metrics.</p>
  </a>
</div>

## Quickstarts

<div class="lb-guide-grid">
  <a class="lb-guide-card" href="/quickstart/shopping-assistant/building-custom-ui/">
    <h3>Build a custom shopping assistant</h3>
    <p>Learn how to manage assistant state, render questions, keep hit payloads lean, and apply runtime field overrides.</p>
  </a>
</div>

## API reference

<div class="lb-guide-grid">
  <a class="lb-guide-card" href="/shopping-assistant/api/assistant/">
    <h3>Assistant API endpoint</h3>
    <p>Run an assistant flow, send the current answers, and receive matching hits plus the next question.</p>
  </a>
</div>