Skip to content

    Pre-launch API. The concepts described here are settled, but the API shape is not: request and response fields, parameters and defaults can still change. Build against it, and talk to your Luigi's Box contact before you put an integration into production.

    Rendering results yourself, or integrating something that is not a website?

    You are reading the API path.

    Build for the Agentic World.

    Include one script and you get a git repo with a ready-made scaffold and skills your coding agent already understands. Tell the agent what you want on the page, review the diff, and git push. The script rebuilds on every push and your integration is live.

    Build for the Agentic World.

    Everything is reachable through OAuth-authenticated APIs. Generate a client from the OpenAPI spec, point your agent at the docs, and start building.

    example-com — zsh
    API='https://api.eu1.luigisbox.ai/discovery/v1/search'
    
    curl -X POST "$API?channel_id=lbn_4hj9tv&surface_id=lbs_search_main" \
      -H 'Authorization: Bearer <token>' \
      -H 'Content-Type: application/json' \
      -d '{ "type": "product", "query": "blue t-shirt", "size": 24 }'

    Response 200

    {
      "hits": [
        {
          "@id": "product/sku-1001",
          "@type": "product",
          "@title": "Blue Cotton T-Shirt",
          "price": 29.9,
          "list_price": 39.9,
          "availability": 1,
          "url": "https://example.com/products/blue-cotton-t-shirt"
        }
      ],
      "total": 412,
      "guid": "b8f1c2e4-6a7d-4f39-9c02-15d8ae37b6c1",
      "next_page_cursor": "eyJvIjoyNCwic…",
      "pagination_status": "more"
    }

    From an empty repository to a released integration

    Your first five minutes with the API

    Your first integration Backend quickstart
    1. Create the repository Hub → Front-end Integration A form in the Hub, or one API call. Seeded with the scaffold and the skill pack.
    2. Clone and set up git clone … && yarn setup Your Luigi’s Box credentials. No SSH keys.
    3. Point an agent at your site /integrate example.com It handles the catalog and the storefront.
    4. Push and review git push origin testing The push builds. Review at ?_lbx_env=testing.
    5. Release merge to main Built, checked against your live pages, published.
    1. Get a token POST /oauth/token Your M2M client credentials, exchanged for a bearer token.
    2. Index a product POST /index/v1/lbc_8w3k2p/index/ Your own field names and shapes.
    3. Search for it POST /discovery/v1/search Ranked hits, facets on request.
    4. Report a purchase POST /events/v1/events What ranking learns from.
    5. Apply your business rules POST /platform/v1/campaigns Pin, ban, boost or bury — targeted, and on a schedule.