Help Page Home

GET v1/YouMayLike?excludedItemIdentifier={excludedItemIdentifier}&limit={limit}&fields={fields}&fallbackToPopular={fallbackToPopular}&trackerReference={trackerReference}

Returns the You May Like Items

Request Information

URI Parameters

excludedItemIdentifier string

Identifier of the item to exclude from results (e.g. Item that is already being displayed).


limit integer

Number of results requested.

Optional - Default: 20

fields string

Comma-separated list of fields to include in the response.

Optional - Default: "Identifier"

fallbackToPopular boolean

Whether or not Most Popular items should be returned when results are empty.

Optional - Default: false

host HostPage

Host Page on which the recommendations will be rendered.

trackerReference string

Additional tracker reference data.


Body Parameters


Response Information

Resource Description

A list of popular items.

Collection of Item
Identifier string

Item's unique identifier in its source system.


Title string


ItemType string

Item type.

Price decimal number

Price (if applicable).

OriginalPrice decimal number

Original Price (if applicable, and the "Price" is discounted).

DisplayUrl string

URL by which the Item is accessible (if applicable).

Description string


ImageUrl string

Image URL (if applicable).

Prevalence integer

Indicates the relative frequency with which an item appears.

Value must be between -5 and 5

CollectionPrevalence integer

Indicates the relative frequency with which a collection appears.

Value must be between -5 and 5

PopularityIndex integer

Overall popularity index calculated based on user behavior feedback.

Read only

TrendingIndex integer

Attribute1 string

First option (attribute) value.

Attribute2 string

Second option (attribute) value.

Attribute3 string

Third option (attribute) value.

Attribute4 string

Fourth option (attribute) value.

Attribute5 string

Fifth option (attribute) value.

Tags string

Comma-separated tags applicable to the item.

Active boolean

Indicates whether item is active or not.

Default is true

Collections Collection of string

List of collection identifiers this item belongs to.

UpdateDate date

Latest update date.

Response Formats

application/json, text/json

    "Identifier": "sample string 1",
    "Title": "T-Shirt",
    "Description": "Sample T-Shirt",
    "Prevalence": 0,
    "PopularityIndex": 2,
    "Attribute1": "Red",
    "Attribute2": "XL",
    "Attribute3": "Men",
    "Attribute4": "Attribute4 value",
    "Attribute5": "Attribute5 value",
    "Tags": "Tee,Shirt,T-Shirt"
    "Identifier": "sample string 2",
    "Title": "Shoe",
    "Description": "Sample Shoe",
    "Prevalence": 0,
    "PopularityIndex": 1,
    "Attribute1": "Black",
    "Attribute2": "8",
    "Attribute3": "Women",
    "Attribute4": "Attribute4 value",
    "Attribute5": "Attribute5 value",
    "Tags": "Footwear,Shoe"