Area: Episerver Product Recommendations
Applies to versions: 1.4 and higher (Personalization API)
Other versions:

Recs only endpoint

Recommendations [hide]

The requester needs to supply us the following information as JSON.

Parameters Description

[Optional] Language code of the store, for example:

"lang" : "en-gb"

If not supplied, the above is used by default.


[Optional] For example:

"user" : {…}

Note: When you provide user, also supply id; email is deprecated.


[Deprecated] [Optional] The email address of the customer. For example:

"email" : "john.customer@email.com"

Note: Use id instead because email is deprecated and kept for backward compatibility.


[Optional] Pseudonymised ID of the user. For example:

"id" : "abcd1234efgh"

This identifies the user in the Personalization system. Use the user ID to improve tracking and recommendations; you can use it also in other Episerver products, such as Mail and Triggers.

Note: For Product Recommendations, to prevent user behavior from being lost, you need to send us an up-to-date mapping between email addresses and pseudonymized user IDs. This only needs to be provided once so that Episerver Personalization can replace existing customer email addresses with their corresponding pseudonymized user ID.


[Optional] Information about the customer, such as their diet, allergies, gender, loyalty card information. This is given in key-value pairs; the keys need to be defined with Episerver before use. For example:

"info" : {
           "gender"  : "female", 
           "allergy" : "nuts",
           "diet"    : "vegan"
           "store"   : "StreamlyCool Bluewater"
           "colour"  : "yellow"
           "size"    : "10"

New records are created; existing records are updated.


The ID of the widget campaign.

"campaignId" : "k3Rw892i"

[Optional] Controls which attributes to show in the smartRecs callback.

"smartRecs"  : {…}

[Optional] A comma-separated list of attribute names to send in the smartRecs callback.

If this property is not supplied, no attributes are sent. If this property is set to "*", all available attributes are sent.

"showAttributes" : ["*"]

[Optional] A list of products to influence the product recommendations.

"items" : ["ref01", "ref02", "ref03"]

[Optional] A list of products to exclude in the product recommendations

"excludeItems" : ["ref97", "ref98", "ref99"]

[Optional] Recommendation content configuration for Product Recommendations. Available values are:

  • full. Full product details in the returned recommendation (such as, prices, image, title, URL). This is the default behavior if the recContent property is omitted.
  • refCodeOnly. Only returns a list of elements with the reference code and the ID.
Not yet implemented.

[Optional] Controls how much A/B test information to return in the response data. Available values are:

  • summary. Only the test name and the A/B group are returned in the response.
  • full. All the available A/B group information is returned in the response.

If this attribute is omitted, no A/B Testing information is returned in the response.

"abTestContent" : "full"


  "lang"          : "en-gb",
  "campaignId"    : "k3Rw892i",
  "items"         : ["ref01", "ref02", "ref03"],
  "excludeItems"  : ["ref97", "ref99", "ref99"],
  "abTestContent" : "full",
  "smartRecs"     : {
	              "showAttributes": ["*"]
  "user"          : {
                      "id"   : "abcd1234efgh",
                      "info" : {
                                 "gender"  : "male", 
                                 "allergy" : "dairy",
                                 "diet"    : "vegetarian"

If no user information is sent in the request, the response contains non-personalized product recommendations, such as best sellers. If user information is supplied, the product recommendations are personalized.

  • The URL for testing in the UAT environment is:
    • https://uat.peerius.com/tracker/smart-api/recommendations
  • The URL with the production end point follows one of the following formats, depending on your provisioned environment:
    • https://<sitename>.peerius.com/tracker/smart-api/recommendations
    • https://<sitename>.peerius.episerver.net/tracker/smart-api/recommendations

Contact Episerver if you are unsure which domain applies to your integration.


  • The sitename part of this address is assigned by Episerver.
  • This entry point requires a request header containing the authentication parameters defined in the Header information section.
  • The request body needs to be sent in a POST request.
  • Always ensure that HTTPS is in the URL.
Do you find this information helpful? Please log in to provide feedback.

Last updated: Nov 06, 2017

Recommendations [hide]