Retrieve details about a listing
Learn how to return detailed information about an Amazon listing for a given selling partner and Amazon marketplace.
Learn how to return detailed information about an Amazon listing for a given selling partner and Amazon marketplace. The details returned can include a number of optional datasets that provide important information about the state of the listing.
Important
The new
LISTINGS_ITEM_STATUS_CHANGE
notification mentioned in the following paragraphs is available only to sellers. TheLISTINGS_ITEM_ISSUES_CHANGE
notification is available to sellers and vendors.
For example, if you have subscribed to receive the LISTINGS_ITEM_ISSUES_CHANGE
notification using the Selling Partner API for Notifications (Notifications API) and you receive the notification, you can call the getListingsItem
operation of the Listings Item API to get more details. The LISTINGS_ITEM_ISSUES_CHANGE
notification does not include the same level of detailed information about issues as does the API. To return more detailed information, call getListingsItem
and specify issues
in the includedData
parameter to get the issues dataset.
Similarly, if you subscribe to the LISTINGS_ITEM_STATUS_CHANGE
notification using the Notifications API and you receive the notification, you can call the getListingsItem
operation to receive more detailed info. For example, if a listing ceases to be DISCOVERABLE
as indicated in the notification, you might want to get the issues dataset to determine the reason for the search suppression.
For another example, if the LISTINGS_ITEM_STATUS_CHANGE
notification does not indicate that the listing is buyable (Status does not include BUYABLE
), a common reason could be a lack of inventory. In that case, call the getListingsItem
operation and include fulfillmentAvailability
in the includedData
parameter to return the fulfillmentAvailability
dataset.
In general, the datasets available using the includedData
parameter helps you better understand the status of the listing. The datasets available include summary information, contributed attributes, issues, offer information (sellers), fulfillment availability (sellers), and procurement details (vendors).
Prerequisites
To complete this tutorial, you need:
- Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
- Approval for the Product Listing role in your developer profile.
- The Product Listing role selected in the App registration page for your application.
Submit listings item GET request
Call the getListingsItem
operation to return details about a listings item.
Updated about 17 hours ago