SellerLookup

The SellerLookup operation returns detailed information about sellers and, in the US locale, merchants. To lookup a seller, you must use their seller ID. The information returned includes the seller's name, average rating by customers, and the first five customer feedback entries. SellerLookup will not, however, return the seller’s e-mail or business addresses.

	Note
	A seller must enter their information. Sometimes, sellers do not. In that case, SellerLookup cannot return some seller-specific information.

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.

Customers can rate sellers. 5 is the best rating; 0 is the worst. The rating reflects the customer's experience with the seller. The SellerLookup operation, by default, returns review comments by individual customers, as shown in the next example:

<AverageFeedbackRating>3.0</AverageFeedbackRating>
<SellerFeedback>
  <Feedback>
    <Rating>1</Rating>
    <Date>2006-06-01T01:58+0000</Date>
    <RatedBy>A59KKB5O4U1NE</RatedBy>
  </Feedback>
  <Feedback>
    <Rating>5</Rating>
    <Comment>Super fast shipping and in great condition.</Comment>
    <Date>2006-05-07T19:57+0000</Date>
    <RatedBy>AYJHDY02HJ2XY</RatedBy>
  </Feedback>

As shown in this response snippet, the average of all seller ratings entered by customers is returned in the Seller/AverageFeedbackRating element.

Get information about three different sellers.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=SellerLookup&
SellerId=[A Seller ID],[A Seller ID],[A Seller ID]
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

The response to this request is shown in, Response to Sample Request.

Use FeedbackPage to retrieve the third page of feedback:

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService
&AWSAccessKeyId=[ID]&
Operation=SellerLookup&
SellerId=[Seller ID]&
FeedbackPage=3
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

You can retrieve up to ten pages of feedback, which corresponds to fifty total feedback entries; five per page. By default, SellerLookup returns the first five pieces of customer feedback for the specified seller(s)

</SellerLookupResponse>
  </Sellers>
  <Seller>
    <SellerId>ATVPDKIKX0DER</SellerId>
    <SellerName>Amazon.com</SellerName>
    <SellerLegalName>Amazon.com, LLC</SellerLegalName>
    <GlancePage>http://www.amazon.com/gp/help/seller/at-a-glance.html?seller=ATVPDKIKX0DER&marketplaceSeller=1</GlancePage>
    <SellerFeedback>
      <Feedback>
        <Rating>1</Rating>
        <Comment>As clearly indicatedabove, I ordered "How to Do Everything with Windows XP Home Networking" by Dave Field, but received instead "How to Do Everything with Windows XP" by Curt Simmons, a totally different book, for which I have no use.</Comment>
        <Date>2006-06-01T01:58+0000</Date>
        <RatedBy>A59KKB5O4U1NE</RatedBy>
      </Feedback>
      <Feedback>
        <Rating>5</Rating>
        <Comment>Super fast shipping and in great condition.</Comment>
        <Date>2006-05-07T19:57+0000</Date>
        <RatedBy>AYJHDY02HJ2XY</RatedBy>
      </Feedback>
      <Feedback>
        <Rating>1</Rating>
        <Comment>I STILL have not received this, four days after the promised delivery date.</Comment>
        <Date>2006-04-24T15:18+0000</Date>
        <RatedBy>A104KQK2R3U0MM</RatedBy>
      </Feedback>
    </SellerFeedback>
  </Seller>
  </Sellers>
</SellerLookupResponse>