Overview
Welcome — index your first catalog to get started
No catalog found on this key yet. The statistics below (searches, zero-result rate, errors) will only make sense once real products are indexed — no need to wait to get started, one call is enough:
curl -X POST https://api.heurix.fr/v1/index/mycatalog/items \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"items": [{"id": "sku-1", "name": "My first product", "stock": 10}]}'The catalog mycatalog is created automatically on the first call — no prior setup required. Want a step-by-step guide instead of a standalone command? See "How it works".
Search volume
Conversion & ROI
These figures depend on the tag you install on your site — Heurix doesn't measure them on its own. "Total revenue" is aggregated over the period (a correlation, not proof). "Actually attributed revenue" only counts purchases where the same visitor clicked from a search within the previous 24 hours — more precise, but requires the Heurix Tracker.
Top products
| Product | Volume | Revenue | Margin |
|---|
No purchases reported for this period — check that the tag is properly installed.
Searches
| Query | Count | Results (avg.) |
|---|
No searches in this period.
What your customers search for and never find — potentially missed sales. Each row is a candidate for a synonym or a rule to add.
| Query | # of times |
|---|
No zero-result searches in this period — good sign.
| What happened | When |
|---|
No errors in this period.
Highlight on search
These settings only change this screen: nothing is saved, and your visitors see no difference. Two of them — hiding out-of-stock products, filtering by radius — are sent with the test query, exactly as your own site would.
How to reorder two products
- Click on a product to put it at the top.
- Do the same on a second product.
- Drag one pinned card onto the other to swap them — or use the arrows ▲▼, equivalent and keyboard-usable.
- Click Publish to save.
— or read below.
Moving a product also locks the positions above it: several rules therefore appear from a single click. Nothing is saved until you click Publish.
Rules on this search
Quick view, without leaving the preview. For the full list and bulk management, see the Catalog rules tab.
No rule on this search.
Create a synonym
Link "" to other equivalent words — your customers will find the same results typing either one.
Results preview
Type a query to see the real ranking, and why each product shows up. The arrows move a product one spot, the pin puts it at the top.
Good to know: moving a product also locks the positions above it — several rules will appear from a single click, that's normal. Nothing is saved before .
Active filter: the arrows are disabled. They lock the positions of the displayed list — on a filtered list, the resulting rules would no longer make sense once the filter is removed. Pinning, however, remains possible.
No product in this catalogue carries coordinates. The radius therefore cannot find anything, and this zero comes from your data — not from the distance you asked for. Add lat and lon to your products on the next upload: no reindexing is needed.
No results for this query.
Active rules
The position is the product's final rank: position 3 places it 3rd, other products filling the remaining slots. Buried products always go to the end of the list.
| Rule | Status |
|---|
No rule set on this catalog.
Add a rule
Category merchandising Browse plan
Ranking preview
Rank your products on a category page of your site, without search — full documentation.
These settings only affect this screen. They don't change what your visitors see.
Nothing is saved before .
How to reorder two products
- Click on a product to put it at the top.
- Do the same on a second product.
- Drag one pinned card onto the other to swap them — or use the arrows ▲▼, equivalent and keyboard-usable.
- Click Publish to save.
Moving a product also locks the positions above it: several rules therefore appear from a single click. Nothing is saved until you click Publish.
No product in this category.
Sorting rules
Pin a product to an exact position, or bury it at the end of the list — regardless of the sort chosen above.
| Product | Action | Position |
|---|
No rule set on this category.
Add a rule
Feature — or demote — every product sharing an attribute (a brand, a color…), without targeting them one by one. A per-product demotion always keeps priority over an attribute boost.
| Attribute | Value | Action |
|---|
No attribute rule set on this category.
Add a rule
Choose a category to see its ranking.
Engine vocabulary
Synonyms bring the words your customers use closer to those in your catalog.
Choose a catalog to manage its synonyms and recognitions.
Teach the engine the words of your trade: a reference, a standard, a material. It will recognise them in your product listings and in your visitors' searches.
Products
Products shown on your category pages, cross-referenced with their clicks from search. A product shown a lot but rarely clicked is a candidate for demotion; the reverse, for pinning.
No category page views reported yet. This data needs the Heurix.trackCategoryView() call from your category pages — see the documentation.
Products frequently bought in the same basket, from actual order counts — not a predictive model. Requires at least 5 purchases of the chosen product over the period to be reliable.
| Related product | Bought together | Of observed baskets |
|---|
Segmentation
Visitor breakdown by intent, inferred from their search style (precision) and click-through rate — never from their identity: Heurix only knows a pseudonymous identifier, never a name or email. Default thresholds haven't been calibrated against real conversion data yet.
– visitors identified over the period
Install the tracker to see your segments
Segmentation infers purchase intent from your visitors' searches and clicks. It requires a tag on your site — no data is collected without it.
See the Heurix Tracker documentation →Guides
Every Heurix article and guide, without leaving the console. Opened in a new tab to keep your session here.
Guided tour of the rule editor
Seven steps on your own data, in the console. Nothing is saved during the tour: you can try everything.
Getting started
- Why vector search fails on technical catalogs
- Elasticsearch and Lucene: what you'll build yourself
- Usage guide: running your search day to day
- Getting started guide — from sign-up to full setup
- Index your first catalog in 5 minutes
- Building a category page with Browse & Discovery
- Connecting Heurix to Claude Desktop and Cursor (MCP server)
Configuring search
Why Heurix, comparisons
Import a file
Three things to know before your first import
- The identifier matters most. It's what lets a product be updated instead of duplicated. Re-importing the same file duplicates nothing.
- Use the same identifier everywhere. If your site sends product references to the conversion tracker, index with those same references — otherwise your sales analytics will stay empty.
- The rule pack is chosen up front. We analyze it from your file and preselect it. Changing it afterward requires re-importing.
Drop the export from your store or management software (ERP, PIM). We detect the structure and suggest a field mapping, which you can adjust before sending.
- 1 Drop your file CSV or XML export from your store
- 2 Check the mapping We detect your columns, you adjust if needed
- 3 It's indexed Search up to date within minutes
or drop it here
Accepted formats
- CSV — comma or semicolon separator, UTF-8 encoding
- XML — standard PrestaShop or WooCommerce export
- Up to 100,000 rows, around 50 MB
Columns detected automatically
name · reference · price · stock · category · brand · image
Only the identifier is required. Other columns are optional, and you can adjust the mapping after dropping the file.
Running PrestaShop, WooCommerce or Shopify? See the integration guide.
The import replaces the selected catalog. Nothing is published until indexing succeeds.
Field matching
Check each field. Only the identifier is required: it's what lets a product be updated instead of duplicated.
How it works
What a rule pack does
A rule pack reads your product references and automatically recognizes what they contain — as in the diagram above. Eleven packs currently exist, covering the most common industries (hardware, fashion, industry, books, electronics, wine & spirits, automotive, electrical, plumbing, finance, sport & surf).
Create a custom rule
Possible directly from each catalog card, with no code to write — two formats to choose from. Here's exactly what to fill in:
Your customers type "anchor," others "molly" or "drywall anchor" for the same product.
Keyword → labelAnchoranchor, molly, drywall, drywall anchor→ A search on any of these words finds every product containing any of the other three.
Your references use a standardized code, like a RAL color.
Prefix + number → labelRAL colorRAL→ "RAL 9010" and "RAL9010" (with or without a space) are now recognized as the same value.
More examples by industry (hardware, fashion, beauty, furniture…): see the dedicated blog article.
More complex cases (two combined numbers, like a diameter × a length) aren't covered by these two formats yet. Need that? Write to us — it's doable on the engine side.
Publishing a change
There's no separate publish step: changing a rule pack, editing a synonym, or creating a custom rule takes effect immediately on your live search, as soon as you confirm.
My subscription
Loading…
Change plan
The billing portal is hosted by Stripe: you'll find your invoices and payment method there, and can cancel anytime.
Company
Team
Everyone at your company shares access to the same catalogs and the same API key.
| Role | Member since |
|---|
My API key
Use this in the Authorization: Bearer <key> header of your calls. Don't share it — it grants write access to your catalog.
••••••••••••••••••••••••••••••••
Copied!
Never put this key in a web page
The key above is a server key. It authorizes indexing, merchandising, and access to your billing — placed in a page's JavaScript, it becomes readable by any visitor.
For the search bar, the tracker, or the Browse widget, generate a public key below: it can only search, browse your catalog, and report conversion events. Nothing else.
Public keys (browser)
Use these in heurix-search.js, heurix-tracker.js, and heurix-browse-widget.js. They share your server key's quota — generating several doesn't raise your limits.
| Key | Allowed domains |
|---|
No public key yet.
Generate a public key
Rattacher une boutique
L'app Heurix installée dans l'administration de votre boutique vous demande un code de liaison. Engendrez-le ici, puis recopiez-le dans l'app : il prouve que ce compte est le vôtre, et rattache la boutique à la clé serveur ci-dessus.
Votre mot de passe Heurix ne vous sera jamais demandé dans l'app. C'est ce que ce code existe pour éviter.
Le code précédent reste valable jusqu'à sa propre expiration : en engendrer un nouveau ne l'annule pas.
Suggest an improvement
A feature you're missing, a bug to report, or just a question — it goes straight to our inbox, and a direct reply comes back to your address.