Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In



Fetch production recommendations for a single customer (personal), based on a group of products (contextual), or overall best sellers.

  • For product recommendations based on a customer, the customer can be identified using one of vuid, email, zaius_alias_*, or customer_id.
  • For recommendations based on a group of products, the products can be identified by their respective product ids. Including a customer identifier on this type of request will exclude products purchased in the last 180 days from being returned.

If no customer identifier or product ids are provided (or if no associated recommendations are available), then 7-day best-sellers are returned as fallbacks.

Product records that are returned will include all the base Optimizely Data Platform (ODP) product fields in addition to any custom fields defined in your product schema.

There will be an extra field, recommendation_type, in the returned results. This field shows which types of recommendations are being returned (personal, contextual or best_sellers).

  • personal recommendations refer to products recommended to the specific customer
  • contextual recommendations refer to recommended products related to input products
  • best_sellers are calculated based on the past seven days of orders (by units)



Product recommendation results will automatically be filtered using the Content Shield Filter set up for the account. Query-specific filters (criteria) can be added per the query parameters below.