Skip to content

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.

POST

core.helloretail.com/serve/search

curl https://core.helloretail.com/serve/search \
  -H 'Content-Type: application/json' \
  -d '{
    "key": "{search config key}",
    "query": "running",
    "products": { "count": 10 }
  }'
200 OK
{
  "success": true,
  "products": {
    "totalCount": 12,
    "results": [
      { "title": "Trail Runner 2", "price": 899, "url": "..." }
    ]
  }
}
POST

core.helloretail.com/serve/search

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();
200 OK
{
  "success": true,
  "products": {
    "totalCount": 12,
    "results": [
      { "title": "Trail Runner 2", "price": 899, "url": "..." }
    ]
  }
}
POST

core.helloretail.com/serve/search

<?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'];
200 OK
{
  "success": true,
  "products": {
    "totalCount": 12,
    "results": [
      { "title": "Trail Runner 2", "price": 899, "url": "..." }
    ]
  }
}
POST

core.helloretail.com/serve/search

import requests

response = requests.post('https://core.helloretail.com/serve/search', json={
    'key': '{search config key}',
    'query': 'running',
    'products': {'count': 10},
})

products = response.json()['products']
200 OK
{
  "success": true,
  "products": {
    "totalCount": 12,
    "results": [
      { "title": "Trail Runner 2", "price": 899, "url": "..." }
    ]
  }
}

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 →

Retail Media

Turn your store traffic into revenue with product & banner placements.

Learn more →

Product Intelligence

See what each product is actually worth: lifetime value, repeat-purchase patterns, discount sensitivity and seasonality.

Learn more →

Newsletter Content

Use Newsletter Content to embed personalized product recommendations for each recipient.

Learn more →