人気、価格、コンディションによる並び替え

返された商品の表示順序は、カスタマーにとって重要です。最も安価な商品、最も人気のある商品、コレクター商品などの情報を知りたい場合が多いからです。Product Advertising API は、Sortパラメータにより、このニーズに対応する機能を提供します。このパラメータは、 ItemSearch, ListLookup および SellerListingSearch リクエストで使用します。

Sort パラメータを ListLookup および SellerListingSearch リクエストに指定する場合、有効な値に制限がありますが、これはどの国のサイトでも同じです。Sort パラメータの ItemSearch リクエストにおける有効な値は、国ごと、およびサーチインデックスによって異なります。有効な値の一覧については、国ごとの ItemSearch の並べ替え値をご参照ください。

次の表は、 ItemSearch の Sort パラメータで最もよく指定される値の一部を示したものです。

Sort パラメータ説明
pricerank, price, +price商品を価格の安い順に並べ替えます。この3種類の値の意味はいずれも同じですが、指定するサーチインデックスが異なります。
inversepricerank, -price商品を価格の高い順に並べ替えます。この2種類の値の意味はいずれも同じですが、指定するサーチインデックスが異なります。
salesrank商品を売れている順に並べ替えます。
relevancerank商品は、解説に含まれるキーワードの頻度や場所に基づいてランク付けされます。例えば、キーワードがタイトルに含まれるとランキングが高くなります。複数のキーワードがある場合、説明の文中でキーワードが出現する頻度、キーワード検索で抽出した商品をカスタマーが結果的に購入した頻度を参考にします。
reviewrankカスタマーによるレビューで評価レベルの高い順に商品を並べ替えます。

例えば、次のリクエストは、価格の安い順におもちゃのロケットを並べ替えたリストを返します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemSearch&
Keywords=Rocket&
SearchIndex=Toys&
Sort=price&
ResponseGroup=Offers&
ItemPage=241

次に示すのは、レスポンスの一部です。

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

このレスポンスには、2つの商品(おもちゃのロケット)が価格順に並んでいます。複数のマーチャントと出品者によって同じASINが出品されている可能性があります。 Offers レスポンスグループは、コンディションごとの最低価格をそれぞれまとめて返します。例えば、レスポンスに含まれている最初の商品 B000BOWQWA については、3人の出品者によってコンディションが "New (新品) " の商品が出品されています (<TotalNew>3</TotalNew>)。コンディションが "New (新品) " である、この商品の最低価格は2.10ドルです。"Used (中古商品) "、"Collectible (コレクター商品) "、"Refurbished (再生品) " コンディションの商品を出品している人はいません。

Sortパラメータの他の全ての値も同様に使用できます。