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 fromcdn.neuroon.ai. There is no officialnpmpackage. Search, voice, image, suggestions and cross-sell. - API Widget (
/api/widget/*) — consumed by the browser, authenticated withX-Widget-Token. - API Plugin (
/api/plugin/shops/*) — consumed by your server to sync products, verify the domain and report conversions. Authenticated withX-Shop-API-Key.
The interactive end-to-end diagram lives in Architecture.
How Neuroon integrates with your store
A minimal viable integration consists of:
- Provisioning a shop in Neuroon (Dashboard) and issuing a
Shop API Key(sk_<32hex>) and aWidget Token. - Syncing the catalog via
POST /api/plugin/shops/{shopId}/products/sync. Batches of up to 500 products per request. - Embedding the widget through a
<script>tag withdata-*attributes (data-token,data-container,data-locale,data-api-url). - Tracking clicks and conversions to close the learning loop.
Continue
- Quickstart — minimal integration in 5 steps, 5–10 minutes.
- Architecture — data flow, eventual consistency, dual authentication.
- What's not supported — honest list of what does not exist.