You can look up individual Marketplace listings of products for sale, as many as ten at a time, by using the SellerListingLookup operation.
For Marketplace items, you need to know the exchange ID. A REST request would look like this:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &AWSAccessKeyId=[ID] &Operation=SellerListingLookup &IdType=Exchange &Id=[ExchangeId]
US only: You cannot use SellerListingLookup to look up products sold by merchants. To look up a product sold by a merchant, use ItemSearch or ItemLookup with the MerchantId parameter.
This request returns information about the product described by the listing, including ASIN, product name, condition, price and other details of the product.
If you do not know the listing ID or exchange ID, you can search seller listings for products in Marketplace with the SellerListingSearch operation. Searches can be done in only one store at a time (Marketplace).
US only: You cannot use SellerListingSearch to look up products sold by merchants. To look up a product sold by a merchant, use ItemSearch or ItemLookup with the MerchantId parameter.
The available parameters for the SellerListingSearch operation vary between the locales. See the SellerListingSearch reference for more information.
You may want to search seller listings for specific sellers. This is useful if you are a seller and you want to see all of your own listings, or all of a direct competitor's listings. Or for customers, this operation allows you to find all products listed by a known seller.
To search for listings of a seller, simply include the SellerId parameter in your operation request. Up to ten listings will be returned per request (or per page), and the SellerListings/TotalPages element will tell you the number of pages (SellerListings/TotalResults contains the total number of listings) available for this seller. You can then use the ListingPage parameter to view other pages of results.
For example, if you wanted to get the second page of listings for a given SellerId value, your REST request might look like this:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &AWSAccessKeyId=[ID] &Operation=SellerListingSearch &SellerId=[ID] &ListingPage=2
The Title parameter for SellerListingSearch allows you to search for product listings by the product's name or characteristics. Title can have multiple words, as long as spaces are URL-encoded as %20 in your REST request.
Title searches do not require the title to be complete and correct, only that the words match. For example, if you wanted to search for books that include "Labrador retriever" in the title, you might use the REST request shown below. Note that in general, keyword searches are more powerful because they search both title and product description.
REST Examples [Show]
Word order in the title list does not matter and case is not significant--searching for Harry%20 Potter is the same as searching for potter%20harry.
By default, SellerListingSearch retrieves only products for which the listing is still open (i.e., the product is still available). You can also search for discontinued, out of stock, or unvailable products. The OfferStatus parameter specifies whether you are searching for Open (available) products or Closed products. For example, if you wanted to see all offers for a video game, or to see the prices for used items that had sold in the past to see how prices had changed in the last six months, you might use a REST request that looked like this:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &AWSAccessKeyId=[ID] &Operation=SellerListingSearch &Title=[GameTitle] &OfferStatus=Closed
The results of a SellerListingLookup are pre-sorted by setting the Sort parameter. By default, results are sorted with featured items first. The complate list of available Sort parameter values are listed in Sort Values in the API Reference.
Note:
You must be an Amazon partner for your items to be eligible as featured items.
Each SellerListingSearch operation returns up to ten product listings. You can use the ListingPage parameter to retrieve additional pages of ten listings, up to 500 pages.
You can page through products with the ListingPage parameter as shown in the table below.
| Parameter | Default Page Number | Items per page | Valid Values | Description |
|---|---|---|---|---|
| ListingPage | 1 | 10 | 1..500 | Products. Up to 500 pages of offers can be returned (10 offers per page). |