Horoshop's built-in search matches exact text only. A customer types "laptpo" with a typo or "Sumsung" instead of "Samsung" — nothing found. The store loses a sale even though the product is right there in the catalog. Spefix fixes this through a single API integration — no developer needed, under one hour.
| Step | Time |
|---|---|
| Registration and domain setup | 5–10 min |
| Creating a user in Horoshop | 5 min |
| API connection and product import | 5–30 min |
| Adding the code to your site | 5 min |
| Widget configuration | 10–15 min |
| Total | 30–60 min |
What's Wrong With Horoshop's Default Search
Horoshop is a solid e-commerce platform popular in Eastern Europe. But its built-in search does "search by name," not "understand what the customer means." A customer types "vacum cleaner" — zero results. Types "Sumsung" — zero. Forgets to switch keyboard layout and types "nhfycajhvfnjh" instead of "transformer" — zero. Searches "headphons" instead of "headphones" — zero.
This isn't a Horoshop flaw — it's a standard limitation of most platform-native search engines. They don't handle typos, brand transliterations, keyboard layouts, word forms, or synonyms.
On Horoshop stores without specialized search, the typical zero-result rate is 15–35% of queries. Every fourth or fifth customer who searches your site finds nothing and leaves.
What Changes After Connecting Spefix
Spefix connects to Horoshop via API — products sync automatically, one code snippet works across all language versions of your site. After setup, search starts understanding customers: typos, Cyrillic/Latin brand names, wrong keyboard layouts, word forms, synonyms — all handled automatically. You can also set up a custom synonym dictionary: "sneakers = trainers = running shoes" — and search will understand all variants.
What You Need Before Setup
- A Horoshop store with an active domain
- Access to Horoshop admin panel — to create a dedicated user and add the code
- A Spefix account — free registration, 14-day trial with no credit card
No other technical requirements.
Step-by-Step Setup
Step 1. Register on Spefix
Go to spefix.com, click "Try for free." Register via email or Google account. Once in the dashboard, create a domain: click "Create domain" and enter your store URL (e.g., https://myshop.com.ua).
Step 2. Create a Dedicated User in Horoshop
Spefix connects to Horoshop via API using a login and password of a separate user — not your main account, but a purpose-built one with limited permissions. This is secure: the user can only see products, with no access to orders, customers, or payments.
- Horoshop Admin → Settings → Admins → "Add"
- Enter email and password
- Select role — content-manager
- Save
Name the user "Spefix" — so it's clear what it's for. If you ever want to disconnect the integration, just delete this user. Not sure how to create the user? Message our support — we'll walk you through it in 2 minutes.
Step 3. Connect the API in Spefix Dashboard
In the Spefix dashboard, go to: Search Settings → Integration. Select integration type "Horoshop" and enter the login and password of the user you just created. Click "Submit."
Spefix connects to the Horoshop API and starts automatically importing products. For a store with 3,000–5,000 products, this takes 5–30 minutes. You can see the status right in the dashboard: "Processing" → "Ready." If the status shows "Error" — don't troubleshoot yourself, just message support with a link to your dashboard.
Step 4. Add the Code to Your Site
While products are importing, you can install the code right away. In the "Integration" section, copy a single line of JavaScript:
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN"></script>
In Horoshop: Admin → Settings → General Settings → Scripts — paste before the closing </body> tag. Save.
One code works on all pages and all language versions. The token is unique — copy it from your dashboard, not from this article. Not sure where to paste the code? Send us access and we'll do it for you.
Step 5. Configure the Widget
In the Spefix dashboard, customize the widget appearance: colors, font, number of suggestions. You'll also need to specify the CSS selector of your search button so the widget opens when customers click it. If you don't know how to find it — message us on Telegram @spefix_pm and we'll help in 5 minutes.
Step 6. Test It
Open your store in an incognito tab (Ctrl+Shift+N) — important, because a regular tab may show a cached version. Click search — the Spefix widget should appear. Test a few queries:
- "Sumsung" — should find Samsung products
- "headphons" — should find headphones
- "nhfycajhvfnjh" — should find transformers
If you see results — everything works. Most store owners at this point immediately test the scariest query from their analytics — the one that returned zero results for months. And they see products.
The next morning, the Spefix dashboard will show the first real data: what customers searched for, how many found nothing, which queries are most popular. That number usually surprises people — even those who thought their search was "fine."
Common Issues and How to Fix Them
Widget doesn't appear. Check in an incognito tab — cache may be blocking changes. If that doesn't help, the most common cause is the code being placed in the wrong scripts section.
Some products aren't found. Check the import status in your Spefix dashboard — it shows how many products were imported and if there are any errors. Products marked as "out of stock" may be excluded from the index.
Widget doesn't match your design. Adjust colors in the Spefix dashboard. For deeper customization, use CSS overrides in your Horoshop template.
But honestly — don't spend time debugging on your own. Message us and we'll figure it out together. Telegram @spefix_pm or [email protected].
Setup takes under an hour. No developer needed. Customers who used to see "No results found" start finding products today.
Try Spefix on your store — 14 days free, no credit card → spefix.com