商品カテゴリの価格帯を表示する

SearchBins レスポンスグループは指定のカテゴリーに含まれる商品の価格帯を返します。次の ItemSearch リクエストに対するレスポンスは、SearchBins レスポンスグループがどのように商品の価格帯を表示するのかを示しています。

<SearchBinSets>
  <SearchBinSet NarrowBy="PriceRange">
  <Bin>
    <BinName>$25-$49</BinName>
    <BinItemCount>316</BinItemCount>
    <BinParameter>
      <Name>MinimumPrice</Name>
      <Value>2500</Value>
    </BinParameter>
    <BinParameter>
      <Name>MaximumPrice</Name>
      <Value>4999</Value>
    </BinParameter>
  </Bin>
</SearchBinSet>
<Bin>
  <BinName>$0-$24</BinName>
  <BinItemCount>280</BinItemCount>
  <BinParameter>
    <Name>MinimumPrice</Name>
    <Value>0</Value>
  </BinParameter>
  <BinParameter>
    <Name>MaximumPrice</Name>
    <Value>2499</Value>
  </BinParameter>
</Bin>
</SearchBinSet>

このレスポンスを見ると、価格帯が$25~$49の商品の個数は316で、$0~$24の商品の個数は280であることがわかります。

商品の価格帯を確認したら、MaximumPrice および MinimumPrice パラメータを2回目の ItemSearch リクエストで使用し、希望の価格帯に該当する商品のみを取得できます。このリクエストの中で出品情報を返すレスポンスグループのどれかを一緒に指定すると、指定の価格帯に該当する商品の価格情報も取得できます。