SellerListingSearch

Product Advertising API: 2009-11-01

previous page next page

SellerListingSearch

Description

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 Product Advertising API, sellers must have less than 100,000 items for sale. Sellers that have more items for sale should use, instead of Product Advertising API, other seller APIs, including the Amazon Inventory Management System, and the Merchant@ API.

[Note] Note

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

Examples

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.

Request Parameters

Name Description 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.

Type: String

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.

Type: String

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.

Type: String

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.

Type: String

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.

Type: String

Default: SellerListing

No

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

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

  <Availability>Usually ships within 1-2 business days</Availability>
 
  <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>
  
  <Availability>Usually ships within 1-2 business days</Availability>
 
  <Seller>
    <SellerId>A1ZKKOH0E9LH0B</SellerId>
    <Nickname>nostalgia_dot_com</Nickname>
  </Seller>
</SellerListing>

Response

Name Description
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.
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

previous page start next page