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
Sort parameter in
The valid values for the
Sort parameter in
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
|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.
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.
<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
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
Sort parameter values work in a similar way.