Prev		Next

SellerListingLookup

The SellerListingLookup operation enables you to return information about a seller's listings, including product descriptions, availability, condition, and quantity available. The response also includes the seller's nickname. Each request requires a seller ID.

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 than ItemLookup.

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 ECS, other APIs, including the Amazon Inventory Management System, and the Merchant@ API.

Availability

All locales.

Sample Requests

Use SellerListingLookup in the following ways:

The following request returns information about an item specified by a Listing ID.

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[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, below.

Request Parameters

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

Parameter	Definition	Req'd?	Valid Values
`Id`	Number that uniquely identifies an item. The valid value depends on the value for `IdType`.	Yes	Exchange ID Listing ID ASIN SKU
`IdType`	Use the `IdType` parameter to specify the value type of the `Id` parameter value. If you are looking up an Amazon Marketplace item, use Exchange, ASIN, or SKU as the value for `IdType`. Discontinued, out of stock, or unavailable products will not be returned if `IdType` is Listing, SKU, or ASIN. Those products will be returned, however, if `IdType` is Exchange.	Yes	Exchange Listing ASIN SKU
`SellerId`	Alphanumeric token that uniquely identifies a seller. This parameter limits the results to a single seller ID.	Yes except when `IdType` = Exchange	Valid Seller ID
`ResponseGroup`	Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas.	No	Request (Default) SellerListing (Default)

SellerListingLookup 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.

<SellerListing>
  <ExchangeId>Y02Y3120110Y3481102</ExchangeId> 
  <ListingId>0411W027887</ListingId> 
  <Title>Spartas, Dale C. (photographs by) and Steve Smith (text by): Just Labs</Title> 
  <Price>
    <Amount>2200</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$22.00</FormattedPrice> 
  </Price>
  <StartDate>2001-04-11</StartDate> 
  <EndDate>2004-03-26</EndDate> 
  <Status>Open</Status> 
  <Quantity>1</Quantity> 
  <QuantityAllocated>0</QuantityAllocated> 
  <Availability>Usually ships within 1-2 business days</Availability> 
  <FeaturedCategory>68297</FeaturedCategory> 
  <Seller>
    <SellerId>A3U5ACHDJ10963</SellerId> 
    <Nickname>alphabooks</Nickname> 
  </Seller>
</SellerListing>

Response Tags

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

Element Tag	Definition
`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.
`QuantityAllocated`	Number of items sold or unavailable. Subtract this value from the Quantity value to determine availability.
`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 staill available (Open), or not (Closed.) Closed products are those that are discontinued, out of stock, or unvailable.
`Title`	Title of the item.

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

Related Operations

SellerListingSearch