Navigation
🚨

Critical Security Migration

The luigisbox.com domain is compromised. Immediate action is required.

1. Update API Base URLs

Replace the base URL for all API requests (Search, Recommendations, Analytics):

https://live.luigisbox.com
➡️ https://live.luigisbox.tech

2. Replace Frontend Script

The .com script is no longer safe. Replace it with the secure version immediately:

[OLD - Delete from site]
<script async src="https://scripts.luigisbox.com/LBX-123.js"></script>
[NEW - Secure Version]
<script async src="https://scripts.luigisbox.tech/LBX-123.js"></script>

3. Update CSP & Firewalls

If you use a Content Security Policy, whitelist the new domain to prevent the browser from blocking the connection.

script-src https://scripts.luigisbox.tech;
connect-src https://live.luigisbox.tech;
⚠️
Emergency Action: If you cannot update the code right now, remove the existing Luigi's Box script until the migration is complete to prevent unauthorized code execution.
Support: support@luigisbox.net MODIFIED: 12/17/2025

Filtering & Examples

This guide covers common use cases for querying the Autocomplete API, including filtering by attributes and handling specific data types.

Basic Principles

  • Endpoint: https://live.luigisbox.com/autocomplete/v2
  • Method: GET
  • Authentication: None required (public endpoint).

Common Scenarios

Retrieve Products, Categories, and Queries in a single request. This is the standard "Autocomplete" behavior.

Request:

  • GET /autocomplete/v2?q=ukulele&type=item:6,category:3,query:3

Breakdown:

  • type: Requests 6 items, 3 categories, and 3 suggested queries.

2. Filtering by Attribute (f_type)

You can filter results for a specific type using the f_<type_name>[] parameter.

Scenario: Show only "Ukulele Straps" within the product results.

Request:

  • GET /autocomplete/v2?q=ukulele&type=item:6&f_item[]=category:Ukulele+Straps

Syntax Rules:

  • Key-Value: field:value (e.g., color:green)
  • Ranges: price:10|50 (Price between 10 and 50). Open ranges: price:10| (10 and up).
  • OR Logic: Multiple filters for the same field act as OR.
    • f_item[]=color:green&f_item[]=color:blue -> Green OR Blue.

3. Sorting (sort_type)

Control the order of results for a specific type.

Scenario: Sort items by price (ascending).

Request:

  • GET /autocomplete/v2?q=ukulele&type=item:6&sort_item=price_amount:asc

Limit results to a specific context, such as a warehouse or language version.

Request:

  • GET /autocomplete/v2?q=iphone&type=item:10&ctx[]=warehouse:central

See Multi-warehouse solution for more details.