Recommenders

Create recommender

Create a new Spark recommender for a specific shop and product feed. Training starts automatically after creation.

post/recommenders

Request body

shop_idstring required

The shop (e-commerce platform) identifier. Max 64 characters, allowed characters: letters, digits, ., _, -.

feed_idinteger required

The product feed ID to use for recommendations.

namestring

Optional human-readable name of the recommender. Max 191 characters.

filtered_productsstring

Optional list of product identifiers (SKUs) to exclude from the recommendations. Max 1000 items, each unique and max 255 characters. Omit the field for no product filter.

filtered_categoriesstring

Optional list of category names to exclude from the recommendations. Max 1000 items, each unique and max 255 characters. Omit the field for no category filter.

included_monthsstring

Optional list of calendar month numbers (1–12) that restrict which purchase history is used for training. Values must be unique, max 12 items. Omit the field to use the full purchase history.

Response

recommender_idstring

feed_idinteger

shop_idstring

{"stackTrail":"paths:/recommenders:post:responses:200:content:application/json:schema:items:properties:last_trained_timestamp","oasType":"schema","type":"unknown"}

statusstring

sequence_numberinteger

namestring

Changes

No recorded changes to this endpoint across all 1 revision of this API.