Using the SellerLookup operation, you can look up information about up to five vendors who sell on Amazon's platform. The SellerLookup operation allows you to retrieve information related to specific vendors' feedback from customers, location, and name. You may look up Amazon Marketplace Sellers or Merchants; the operation accepts as input either a Marketplace Seller ID or a Merchant ID (Merchant IDs apply to the US only).
REST Examples [Show]
The SellerLookup operation returns the seller's name, location, rating, and the first five feedback entries. The rating is returned in the Seller/AverageFeedbackRating element and is expressed as an average of the ratings provided by customers. A rating value of 5 would mean that every customer gave this seller five stars. A rating of 4.5 would mean that the seller received an average of 4.5 stars. Each SellerFeedback/Feedback/ element contains a rating, comment, date and customer ID.
To look up more than one seller in a single request, insert a comma-delimited list of up to five Seller IDs in the SellerId parameter of the REST request. For SOAP requests, information about multiple sellers can be retrieved by including multiple SellerId elements in the request.
For the US only, you can look up a merchant using SellerLookup by specifying a merchant ID rather than a seller ID for the SellerId parameter. Merchants are large Amazon partners who typically have large retail brands of their own. SellerLookup requests with merchant IDs, including the Amazon merchant ID, do not return feedback ratings or customer feedback comments.
By default, SellerLookup returns the first five pieces of customer feedback for the specified seller(s). If Seller/TotalFeedback is larger than five and you wish to retrieve the additional pieces of feedback, you can use the FeedbackPage parameter to retrieve more feedback elements, five at a time. For example, the following REST SellerLookup requests show how to retrieve the second and third pages of feedback:
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[ID] &Operation=SellerLookup &SellerId=[ID] &FeedbackPage=2
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[ID] &Operation=SellerLookup &SellerId=[ID] &FeedbackPage=3
You can retrieve up to ten pages (fifty total feedback entries, at five per page) of feedback.