Prev		Next

SellerListing Response Group

The SellerListing response group returns information about items for sale by sellers in the Marketplace. Information includes such things as price, listing ID, exchange ID, ASIN, title, the date the item was first put on sale, quantity, and so forth, for each of item in the response.

This response group is often used in conjunction with SellerListingSearch and SellerLookup to return comprehensive information about the items in the response.

Relevant Operations

Operations that can use this response group include:

Response Elements

The following table describes the elements returned by SellerListing. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

Response Element	Ancestry	Definition
`Amount`	SellerListing/Price/Amount	The price, in terms of the lowest currency denomination, for example, pennies, of a seller's item.
`ASIN`	SellerListing/ASIN	A number provided by Amazon that uniquely identifies an item.
`Condition`	SellerListing/Condition	Specifies the condition of the item, such as new, used, collectible, or refurbished.
`CurrencyCode`	SellerListing/Price/CurrencyCode	An abbreviation that specifies the formatting of the price.
`EAN`	SellerListing/EAN	European Article Numbering (EAN) is a number that uniquely identifies an item.
`EndDate`	SellerListing/EndDate	Specifies a date when the item will stop being sold.
`ExchangeId`	SellerListing/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.
`FormattedPrice`	SellerListing/Price/FormattedPrice	The price of an item formatted as it should be displayed to the customer.
`Image`	SellerListing/Image	An image associated with a seller's item.
`ListingId`	SellerListing/ListingId	A number that uniquely identifies a seller's item within a given year. This values, also known as the Exchange Code, is a shortened form of the ExchangeId, whose uniqueness is not limited to a single year.
`Nickname`	SellerListing/Seller/Nickname	Seller's nickname
`Quantity`	SellerListing/Quantity	The number of items in stock.
`SellerId`	SellerListing/Seller/SellerId	A number that uniquely identifies a seller.
`SKU`	SellerListing/SKU	Stock Keeping Unit (SKU) is a number that uniquely identifies a seller's item.
`StartDate`	SellerListing/StartDate	The data an item goes on sale.
`Status`	SellerListing/Status	Specifies whether an item is for sale (Open) or not (Closed). To determine if an item is truly available, this value must be Open, Quantity must be greater than zero and also the value of QuantityAllocated.
`StoreId`	SellerListing/Seller/StoreId	A number that uniquely identifes the seller's store.
`StoreName`	SellerListing/Seller/StoreName	The name of the seller's store.
`SubCondition`	SellerListing/SubCondition	The condition of an item. This tag helps to further describes items that are not new. Values, for example, are mint, very good, and good.
`Title`	SellerListing/Title	The title of the seller's item for sale.
`UPC`	SellerListing/UPC	Universal product code of the item.
`WillShipExpedited`	SellerListing/WillShipExpedited	Specifies whether seller can ship items faster than normal delivery.
`WillShipInternational`	SellerListing/WillShipInternational	Specifies whether seller will ship item to international destinations.

SellerListing also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.

Parent Response Group

The following response groups are parent response groups of SellerListing.

None

Child Response Group

The following response groups are child response groups of SellerListing.

None

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by SellerListing.

http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService&
AWSAccessKey=[Access Key ID]&
Operation=SellerListingSearch&
SellerId=[Seller ID]&
ResponseGroup=SellerListing

Sample Response Snippet

The following response snippet shows the elements returned by SellerListing.

<SellerListing>
  <ExchangeId>Y06Y0322155Y6575786</ExchangeId> 
  <ListingId>0909R298811</ListingId> 
  <ASIN>0451205367</ASIN> 
  <Title>Richest Man in Babylon [Paperback] by Clason, George S.</Title> 
  <Price>
    <Amount>273</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$2.73</FormattedPrice> 
  </Price>
  <StartDate>2005-09-10</StartDate> 
  <EndDate>2008-08-25</EndDate> 
  <Status>Open</Status> 
  <Quantity>293</Quantity> 
  <Condition>new</Condition> 
  <SubCondition>new</SubCondition> 
  <Seller>
    <SellerId>ASYDZOX0HKBSE</SellerId> 
    <Nickname>any_book</Nickname> 
  </Seller>
</SellerListing>