Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

Sort by Popularity, Price, or Condition

How you display items is important to customers. Customers want information, such as price, popularity, and which items are collectibles. You can organize items with the Sort parameter in ItemSearch requests.

The valid values for the Sort parameter in ItemSearch requests vary by locale and search index. For more information, see Locale Reference for the Product Advertising API.

The most common Sort parameter values are described in the following table.

Sort Parameter Description
pricerank, price, +price Order items by price, from least to most expensive. The three versions of this value are the same, but are valid in different search indices.
inversepricerank, -price Order items by price from most to least expensive. The two versions of this value are the same, but are valid in different search indices.
salesrank Order items from best to worst selling.
relevancerank Order items by keywords. Rank is determined by the keywords in the product description, if there are multiple keywords, how closely they occur in descriptions, and how often customers purchased items they found using the keyword. Keyword placement is also important. For example, the rank is higher when keywords are in titles.
reviewrank Order items by customer reviews, from highest to lowest ranked.

For example, the following request returns a list of toy rockets sorted from least expensive to most expensive.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate Tag]& Operation=ItemSearch& Keywords=Rocket& SearchIndex=Toys& Sort=price& ResponseGroup=Offers& ItemPage=10 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

The following is a snippet of the response.

Copy
<Item> <ASIN>B000BOWQWA</ASIN> <OfferSummary> <LowestNewPrice> <Amount>210</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$2.10</FormattedPrice> </LowestNewPrice> <TotalNew>3</TotalNew> <TotalUsed>0</TotalUsed> <TotalCollectible>0</TotalCollectible> <TotalRefurbished>0</TotalRefurbished> </OfferSummary> </Item> <Item> <ASIN>B0006N6MGW</ASIN> <OfferSummary> <LowestNewPrice> <Amount>211</Amount> <CurrencyCode>USD</CurrencyCode> <FormattedPrice>$2.11</FormattedPrice> </LowestNewPrice> <TotalNew>2</TotalNew> <TotalUsed>0</TotalUsed> <TotalCollectible>0</TotalCollectible> <TotalRefurbished>0</TotalRefurbished> </OfferSummary> </Item>

This response lists two toy rockets, which are sorted by price. The same ASIN can be offered for sale by multiple merchants and sellers. The Offers response group includes a summary of the lowest price per condition. For example, the first item, B000BOWQWA, is sold as new by three sellers. The lowest price for the item in new condition is $2.10. No one is selling the item in used, collectible, or refurbished condition.

All other Sort parameter values work in a similar way.