Advanced features

Luigi’s Box Autocomplete integrates seamlessly with other services like Fixits, Banners, and Recommender.

Fixits (redirects)

Autocomplete can automatically handle “Fixit” rules (redirects) that you define in the application.

• Mechanism: If a user’s query exactly matches a Fixit rule, the API response will include a suggested_url.
• Action: Your frontend should check for this suggested_url and redirect the user immediately, skipping the search results page.

Example response:

{
  "suggested_url": "http://www.e-shop.com/special_landing_site/HP?lb_redirected_from=harry+potter"
}

Banner campaigns

You can display banner campaigns directly in the autocomplete dropdown (e.g., for specific brands or seasonal promotions).

• Data source: Banners are managed in the Luigi’s Box application.
• Response: The API returns a campaigns array containing banner image URLs for desktop and mobile, along with the target URL.
• Documentation: See Banner campaigns for setup instructions.

Example response:

{
  "campaigns": [
    {
      "id": 9,
      "target_url": "https://www.e-shop.com/harry-potter",
      "banners": {
        "autocomplete_list": {
          "desktop_url": "https://www.e-shop.com/harry-potter-1.jpg",
          "mobile_url": "https://www.e-shop.com/harry-potter-2.jpg"
        }
      }
    }
  ]
}

Query rewrite

The API automatically applies Query rewrite rules to improve relevant results. This happens transparently on the backend; no frontend action is required.

Recommender integration

The Autocomplete API uses the Recommender service as its underlying engine for retrieving:

1. Top items: Popular items shown when the search field is empty.
2. Personalized content: Results tailored to the specific user (if user_id is provided).