SellerLookup
Description
Note | |
---|---|
A seller must enter their information. Sometimes, sellers do not. In that case,
|
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.
Examples
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]
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
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)
Request Parameters
Name | Description | Required |
---|---|---|
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 Type: String 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. Type: String 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. Type: String Default: Seller |
No |
SellerLookup
also accepts the parameters that all operations can use.
For more information, see, Common Request
Parameters.
Sample Response
The following XML is a snippet of the full response to the first sample request.
</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>
Response
Name | Description |
---|---|
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. |
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.