Prev Feedback Next

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, location, 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]Note

A seller must enter their information, such as store location. 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.

Sample Requests

Use SellerLookup in the following ways:

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)

The following table describes the request parameters for SellerLookup. Parameter names are case sensitive.

ParameterDefinitionRequired
FeedbackPage

Specifies the page of reviews to return. Up to five reviews are returned per page. The first page is returned by default. To access additional pages, use this parameter to specify the desired page. The maximum number of pages that can be returned is 10 (50 feedback items).

Valid Values: Integer between 1 and 10, inclusive

Default: None

No
SellerId

Alphanumeric token that identifies the seller.

Valid Values: A valid Seller ID, which is provided by Amazon. In the US locale, you can use a merchant ID.

Default: None

Yes
ResponseGroup

Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas.

Default: Seller

Default: None

No

SellerLookup also accepts the parameters that all operations can use. For more information, see, Common Request Parameters.

Response to Sample Request

The following XML is a snippet of the full response to the first sample request above. 

<Seller>
  <SellerId>A8989898989963</SellerId> 
  <Nickname>alphabooks</Nickname> 
  <GlancePage>http://www.amazon.com/gp/help/seller/at-a-glance.html?seller=A8989898989963&marketplaceSeller=1</GlancePage> 
  <Location>
    <City>Fort Smith</City> 
    <State>AR</State> 
  </Location>
  <AverageFeedbackRating>4.9</AverageFeedbackRating> 
  <TotalFeedback>325</TotalFeedback> 
  <TotalFeedbackPages>65</TotalFeedbackPages> 
  <SellerFeedback>
    <Feedback>
    <Rating>5</Rating> 
    <Comment>fast shipping, great product, absolutely no complaints here! A+</Comment> 
    <Date>2005-11-22T03:25+0000</Date> 
    <RatedBy>A345656565656I</RatedBy> 
  </Feedback>
  <Feedback>
    <Rating>5</Rating> 
    <Comment>Great, thanks for fast shipping!</Comment> 
    <Date>2005-11-21T14:52+0000</Date> 
    <RatedBy>A1212121212203</RatedBy> 
    </Feedback>
  <Feedback>
  <Rating>5</Rating> 
    <Comment>This was a gift for my mother, I was shocked at how quickly she received it considering I purchased it for her! Great Job!</Comment> 
    <Date>2005-11-21T14:19+0000</Date> 
    <RatedBy>A33434343434VG</RatedBy> 
  </Feedback>
  <Feedback>
    <Rating>5</Rating> 
    <Comment>Just as described, lightening shipping.</Comment> 
    <Date>2005-11-21T01:50+0000</Date> 
    <RatedBy>A2I45454545458</RatedBy> 
  </Feedback>
  <Feedback>
    <Rating>5</Rating> 
    <Comment>Item as described; delivered promptly.</Comment> 
    <Date>2005-11-20T23:57+0000</Date> 
    <RatedBy>A1DHHLAVXI4C4D</RatedBy> 
  </Feedback>
  </SellerFeedback>
</Seller>

The following table describes the default response tags included in SellerLookup responses.

Element TagDefinition
AverageFeedbackRating Average of all customer ratings of seller. The value is between 0 and 5 where 5 is the best rating.
City City where the seller is.
Comment String that explains the rating.
Date Date of the review.
Feedback Container for the feedback, including RatedBy, Date, Comment, and Rating.
GlancePage URL of a page that provides summary information about customer feedback.
Location Container for City and State of the seller.
NickName String that identifies the seller.
Rating Number of stars, 0 to 5, where 5 is the best rating.
SellerId An alphanumeric token that uniquely identifies the seller.
State State where the seller is.
TotalFeedback Total number of customer reviews.
TotalFeedbackPages Total number of pages that contain customer reviews. There are five reviews per page. Use this value as the boundary value for the FeedbackPage input parameter.

For more information about the parent elements of these tags, see the appropriate response group in Response Groups.

Related Operations

Prev Copyright Information Next
 Home