Skip to main content

Welcome to Neuroon

Neuroon is an AI-powered semantic search engine for e-commerce. It replaces traditional lexical search (LIKE, full-text) with vector embeddings, learned ranking, and a conversational assistant that understands intent, not just keywords.

This documentation describes what exists today in production. It is not a roadmap and does not list planned capabilities as if they were available. If a capability is not listed here, assume it is not yet implemented and check What's not supported.

Who Neuroon is for

  • Stores with a catalog of at least several hundred products where lexical search already fails (synonyms, long descriptions, heterogeneous attributes).
  • Teams that can sync the catalog through the API (server-to-server) and embed a widget in the front end.
  • Heterogeneous stacks: WordPress/WooCommerce, .NET / DNN, custom stores in Node, PHP, Python, Java, or Ruby.

The three pieces

Neuroon is composed of three pieces that integrate independently:

  • Widget — component embedded via a <script> tag from cdn.neuroon.ai. There is no official npm package. Search, voice, image, suggestions and cross-sell.
  • API Widget (/api/widget/*) — consumed by the browser, authenticated with X-Widget-Token.
  • API Plugin (/api/plugin/shops/*) — consumed by your server to sync products, verify the domain and report conversions. Authenticated with X-Shop-API-Key.

The interactive end-to-end diagram lives in Architecture.

How Neuroon integrates with your store

A minimal viable integration consists of:

  1. Provisioning a shop in Neuroon (Dashboard) and issuing a Shop API Key (sk_<32hex>) and a Widget Token.
  2. Syncing the catalog via POST /api/plugin/shops/{shopId}/products/sync. Batches of up to 500 products per request.
  3. Embedding the widget through a <script> tag with data-* attributes (data-token, data-container, data-locale, data-api-url).
  4. Tracking clicks and conversions to close the learning loop.

Continue