SellerListingLookup
Description
You can also find a seller's items using ItemLookup
. There are,
however, some reasons why it is better to use SellerListingLookup
:
-
SellerListingLookup
enables you to search by seller ID. -
SellerListingLookup
returns much more information thanItemLookup
.
This operation only works with sellers who have less than 100,000 items for sale. Sellers that have more items for sale should use, instead of Product Advertising API, other APIs, including the Amazon Inventory Management System, and the Merchant@ API.
Availability
All locales.
Examples
The following request returns information about an item specified by a Listing ID.
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]
& Operation=SellerListingLookup& SellerId=[Seller ID]
& IdType=Listing& Id=[Offer Listing ID]
The response to this request is shown in, Response to Sample Request.
Request Parameters
Name | Description | Required |
---|---|---|
Id
|
Number that uniquely identifies an item. The valid value depends on the value
for Type: String Default: None Valid Values:Exchange ID | Listing ID | ASIN | SKU |
Yes |
IdType
|
Use the Type: String Default: None Valid Values: Exchange | Listing | ASIN | SKU |
Yes |
SellerId
|
Alphanumeric token that uniquely identifies a seller. This parameter limits the results to a single seller ID. Type: String Default: None Valid Values: Valid Seller ID Constraint: Required except when IdType = Exchange. |
Conditional |
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: SellerListing (Default) |
No |
SellerListingLookup
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.
<?xml version="1.0" encoding="UTF-8"?> <SellerListing> <ExchangeId>Y11M6070795M8983336</ExchangeId> <ListingId>1108L899040</ListingId> <ASIN>8478888640</ASIN> <SKU>Y EL CALIZ DE FUEGO</SKU> <WillShipExpedited>0</WillShipExpedited> <WillShipInternational>0</WillShipInternational> − <Title> Harry Potter y El Caliz de Fuego (Spanish Edition) [Paperback] by Rowling, J. K. </Title> − <Price> <Amount>1390</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$13.90</FormattedPrice> </Price> <StartDate>2009-03-30</StartDate> <Status>Open</Status> <Quantity>3</Quantity> <Condition>new</Condition> <SubCondition>new</SubCondition> − <Seller> <SellerId>A3TWXQJ2WJKWBJ</SellerId> <Nickname>READERS</Nickname> </Seller> </SellerListing>
Response
Name | Description |
---|---|
Amount
|
Price of the item in terms of the lowest currency denomination, for example, pennies. |
Availability
|
How quickly the item will be shipped. |
CurrencyCode
|
Format for the display of the money |
EndDate
|
End of life for the item’s sale. |
ExchangeId
|
Token that uniquely identifies an offer in the Marketplace. Exchange IDs are available for every item offered by a third-party seller. When using ExchangeId, you must also specify a matching SellerId and ASIN. |
FeaturedCategory
|
Browsenode ID of a featured category, which is determined by business arrangements between Amazon and a seller. This value is not returned for JP, FR, and CA. |
FormattedPrice
|
The price to display on the web site. |
ListingId
|
Token that uniquely identifies an item. |
NickName
|
String that identifies the seller. |
Price
|
Container for pricing information, including Amount, CurrencyCode, FormattedPrice. |
Quantity
|
Number of items in stock. |
Seller
|
Container for seller information, including, SellerId and Nickname |
SellerId
|
Token that identifies the seller. |
StartDate
|
First day the item went on sale. |
Status
|
Specifies whether the product is still available (Open), or not (Closed.) Closed products are those that are discontinued, out of stock, or unavailable. |
Title
|
Title of the item. |
For more information about the parent elements of these tags, see the appropriate response group in Response Groups.