SellerListingLookup

Description

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 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]
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

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 `IdType`. Type: String Default: None Valid Values:Exchange ID \| Listing ID \| ASIN \| SKU	Yes
`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. 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> &#8722; <Title> Harry
    Potter y El Caliz de Fuego (Spanish Edition) [Paperback] by Rowling, J. K.
  </Title> &#8722; <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> &#8722; <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.

Related Operations

SellerListingSearch