Skip to main content

Just getting started with the Recommendation API? See the following documents for details on using this API:


See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the releases for the Recommendation API:


Release Date

Summary of Release

Version 1.1.0 2020-08-25 Added support for a new ITEM enum value in the bidPercentages response field
Version 1.0.0 2019-03-27 Initial release of Version 1.0.0

Version v1.1.0

The Basis enum type now supports the ITEM enum value, which is returned for the findListingRecommendations response payload in the bidPercentages field.

The ITEM enum value indicates the recommended ad rate for a promoted item based on its features and attributes. The recommendation is calculated based on a variety of factors such as item attributes, seasonality, and past performance. This helps sellers determine which items they should promote in their listing campaigns, when to promote those items, and the ad rate that should be set for those items.

Version 1.0.0

This is the initial release of the Recommendation API, Version 1.0.0.

For a list of resources and methods, see the Recommendation API Reference.