You can look up individual zShops or Marketplace listings of products for sale, as many as ten at a time, by using the SellerListingLookup operation.
For zShops items, you need to know the listing ID or exchange ID. A REST request would look like this:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &AWSAccessKeyId=[ID] &Operation=SellerListingLookup &IdType=Listing &Id=[ListingId or ExchangeId]
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 and zShops with the SellerListingSearch operation. Searches can be done in only one store at a time (either Marketplace or zShops but not both).
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
Three parameters to SellerListingSearch allow you to search for product listings by the product's name or characteristics:
Title - searches product names for matching values
Keywords - searches product names and descriptions for matches to words or phrases
BrowseNodes - searches for product categories; only one browse node ID is permitted per search. zShops products are not categorized in the same browse nodes as the other Amazon products.
Title and Keywords are mutually exclusive--you cannot include both of these parameters in a single operation. Both Title and Keywords 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 keyword or title list does not matter and case is not significant--searching for Harry%20 Potter is the same as searching for potter%20harry.
Since the SearchIndex parameter is used to distinguish between zShops and Marketplace searches, browse nodes become valuable for narrowing the search. Marketplace products use the standard Amazon catalog browse nodes and zShops uses its own browse nodes.
The ShipOption parameter allows you to search for seller listings for products that can be shipped from a specified country, or shipped to a specified country. Countries are specified in requests by country code. To search in this manner, you would set the ShipOption parameter to ShipTo or ShipFrom and then include the Country parameter to specify the desired country.
Countries are specified as their country code, as listed in the Reference section of this documentation.
For example, if you wanted to find seller listings for products that relate to Labrador retrievers that can be shipped to Finland, you would make a request that looked like this:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &AWSAccessKeyId=[ID] &Operation=SellerListingSearch &SearchIndex=ZShops &Keywords=Labrador%20Retriever &ShipOption=ShipTo &Country=4000074
You may also want to search seller listings for sellers in particular areas. To do this, include the PostalCode parameter in your request. If the postal code includes a space (like for example, postal codes in the U.K.) it must be URL-encoded as %20 for REST requests.
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 &SearchIndex=zShops &Title=[GameTitle] &OfferStatus=Closed &BrowseNodes=537504
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). |