Developer documentation
Ship commerce that knows the shopper and the catalog
Search, Recommendations, Pages, Product Agents and Product Intelligence, wired into your webshop with JavaScript SDKs, REST and GraphQL APIs, and an MCP server your AI assistant can call directly.
curl https://core.helloretail.com/serve/search \
-H 'Content-Type: application/json' \
-d '{
"key": "{search config key}",
"query": "running",
"products": { "count": 10 }
}'
const response = await fetch('https://core.helloretail.com/serve/search', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
key: '{search config key}',
query: 'running',
products: { count: 10 }
})
});
const { products } = await response.json();
<?php
$ch = curl_init('https://core.helloretail.com/serve/search');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'key' => '{search config key}',
'query' => 'running',
'products' => ['count' => 10],
]),
]);
$products = json_decode(curl_exec($ch), true)['products'];
Get Started
Access our quick start guide to help you get started integrating Hello Retail into your webshop.
Get started →MCP
Connect AI assistants to Hello Retail. The MCP server exposes search, feeds, recommendations, and analytics as tools your assistant can call in plain language.
Explore MCP →API Introduction
I provide a REST API that enables you to access features and implement tracking programmatically. This documentation guides you through a fast and efficient integration process.
Introduction →Support documentation
For guidance on how to get the most out of the platform, visit our documentation here.
Learn more →Browse by solution¶
Every solution has a reference for the surface and a guide for the scenario.
Product Agents
Use Hello Retail’s Product Agents to automatically send relevant, product-aware messages based on customer behavior.
Learn more →Search
Use Hello Retail's Search to deliver personalized, relevant product results for every query.
Learn more →Recommendations
With Hello Retail's Recommendations, you can deliver personalized, tailored product suggestions that drive higher conversion rates and turn more users into customers.
Learn more →Pages
Pages enable you to deliver personalized category and brand pages that reduce bounce rates and increase conversions.
Learn more →Product Intelligence
See what each product is actually worth: lifetime value, repeat-purchase patterns, discount sensitivity and seasonality.
Learn more →