SellerListingSearch

The SellerListingSearch operation enables you to search for items offered by specific sellers. You cannot use SellerListingSearch to look up items sold by merchants. To look up an item sold by a merchant, use ItemLookup or ItemSearch along with the MerchantId parameter.

SellerListingSearch returns the listing ID or exchange ID of an item. Typically, you use those values with SellerListingLookup to find out more about those items.

Each SellerListingSearch request returns up to ten items. By default, the first ten items are returned. You can use the ListingPage parameter to retrieve additional pages of (up to) ten listings.

To use ECS, sellers must have less than 100,000 items for sale. Sellers that have more items for sale should use, instead of ECS, other seller APIs, including the Amazon Inventory Management System, and the Merchant@ API.

	Note
	`SellerListingSearch` requires a seller ID, which means that you cannot use this operation to search across all sellers. ECS does not have a seller-specific operation that does this. To search across all sellers, use `ItemSearch` or `ItemLookup`.

Sample Requests

Use SellerListingSearch in the following ways:

Find items in the Marketplace that have the word, Newton, in the title or item description and sort the items by price where the most expensive items is listed first.
```
http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS Access Key ID]&
Operation=SellerListingSearch&
SellerId=[A Seller ID]&
Keywords=Newton&
Sort=+price&
OfferStatus=Open    
```
The response to this request is shown in, Response to Sample Request, below.

Request Parameters

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

Parameter	Definition	Required
`ListingPage`	Page of the response to return. Up to ten lists are returned per page. For customers that have more than ten lists, more than one page of results are returned. By default, the first page is returned. To return another page, specify the page number. Type: Positive integer. Default: 1 Constraint:Maximum value is 500.	No
`OfferStatus`	Specifies whether the product is available (Open), or not (Closed.) Closed products are those that are discontinued, out of stock, or unavailable. Default: Open (Default) Valid Values:Closed	No
`SellerId`	An alphanumeric token that uniquely identifies a seller. These tokens are created by Amazon and distributed to sellers. Valid Values:A valid Seller ID.	Yes
`Sort`	Use the Sort parameter to specify how your seller listing search results will be ordered. The -bfp (featured listings - default), applies only to the US, UK, and DE locales. Default: None Valid Values: -startdate startdate +startdate -enddate enddate -sku sku -quantity quantity -price price +price -title title	No
`Title`	Searches for products based on the product’s name . Keywords and Title are mutually exclusive; you can have only one of the two in a request. Type: String. The value can be multiple words, as long as the spaces are URL-encoded as %20. Word order does not matter and case is not significant. Default: None	No
`ResponseGroup`	Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas. Default: SellerListing (Default)	No

SellerListingSearch 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>
<SellerListing>
  <ExchangeId>Y01Y1679802Y5496404</ExchangeId> 
  <ListingId>0829W011414</ListingId> 
  <Title>Incredible Journey,Quad Movie Poster, 40" x 30",1963</Title> 
  <Price>
    <Amount>1975</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$19.75</FormattedPrice> 
  </Price>
  <StartDate>2004-08-29</StartDate> 
  <EndDate>2007-08-14</EndDate> 
  <Status>Open</Status> 
  <Quantity>1</Quantity> 
  <QuantityAllocated>0</QuantityAllocated> 
  <Availability>Usually ships within 1-2 business days</Availability> 
  <FeaturedCategory>301787</FeaturedCategory> 
  <Seller>
    <SellerId>A1ZKKOH0E9LH0B</SellerId> 
    <Nickname>nostalgia_dot_com</Nickname> 
  </Seller>
</SellerListing>

Response Tags

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

Element Tag	Definition
`Amount`	Price 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 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

SellerListingLookup