curl https://api2.ecomailapp.cz/recommenders \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api2.ecomailapp.cz/recommenders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'key: YOUR_API_KEY',
'Content-Type: application/json',
]);
$response = curl_exec($ch);
curl_close($ch);
[
{
"recommender_id": "6789abc123def",
"feed_id": 1,
"shop_id": "my-shop",
"last_trained_timestamp": 1710000000,
"status": "ready",
"settings": {
"filtered_products": [],
"filtered_categories": [],
"included_months": []
},
"sequence_number": 1,
"name": "Christmas 2026"
}
]
Recommenders
List all recommenders
Retrieve all Spark recommenders configured for your account.
GET
/
recommenders
curl https://api2.ecomailapp.cz/recommenders \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api2.ecomailapp.cz/recommenders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'key: YOUR_API_KEY',
'Content-Type: application/json',
]);
$response = curl_exec($ch);
curl_close($ch);
[
{
"recommender_id": "6789abc123def",
"feed_id": 1,
"shop_id": "my-shop",
"last_trained_timestamp": 1710000000,
"status": "ready",
"settings": {
"filtered_products": [],
"filtered_categories": [],
"included_months": []
},
"sequence_number": 1,
"name": "Christmas 2026"
}
]
Returns a list of recommender objects, each containing the recommender ID, sequence number, optional name, associated shop and feed, training status and settings.
Recommender status values:
created (just created, waiting to train), training (currently training on EMR), ready (trained and serving recommendations).sequence_number is a stable, per-account identifier that is never reused, even after a recommender is deleted. It is the number referenced by the merge tag *|ECM_SPARK_REC_{sequence_number}_{limit}[N].{field}|* in templates and automations.curl https://api2.ecomailapp.cz/recommenders \
-H "key: YOUR_API_KEY" \
-H "Content-Type: application/json"
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api2.ecomailapp.cz/recommenders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'key: YOUR_API_KEY',
'Content-Type: application/json',
]);
$response = curl_exec($ch);
curl_close($ch);
[
{
"recommender_id": "6789abc123def",
"feed_id": 1,
"shop_id": "my-shop",
"last_trained_timestamp": 1710000000,
"status": "ready",
"settings": {
"filtered_products": [],
"filtered_categories": [],
"included_months": []
},
"sequence_number": 1,
"name": "Christmas 2026"
}
]