PredictedItem - Amazon Personalize
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


An object that identifies an item.

The GetRecommendations and GetPersonalizedRanking APIs return a list of PredictedItems.



The recommended item ID.

Type: String

Length Constraints: Maximum length of 256.

Required: No


Metadata about the item from your Items dataset.

Type: String to string map

Key Length Constraints: Maximum length of 150.

Value Length Constraints: Maximum length of 20000.

Required: No


The name of the promotion that included the predicted item.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Required: No


If you use User-Personalization-v2, a list of reasons for why the item was included in recommendations. Possible reasons include the following:

  • Promoted item - Indicates the item was included as part of a promotion that you applied in your recommendation request.

  • Exploration - Indicates the item was included with exploration. With exploration, recommendations include items with less interactions data or relevance for the user. For more information about exploration, see Exploration.

  • Popular item - Indicates the item was included as a placeholder popular item. If you use a filter, depending on how many recommendations the filter removes, Amazon Personalize might add placeholder items to meet the numResults for your recommendation request. These items are popular items, based on interactions data, that satisfy your filter criteria. They don't have a relevance score for the user.

Type: Array of strings

Length Constraints: Maximum length of 256.

Required: No


A numeric representation of the model's certainty that the item will be the next user selection. For more information on scoring logic, see Recommendation scores.

Type: Double

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: