【Amazon・PA-API】ItemSearchで指定するパラメータについて|SearchIndexなど

AmazonのPA-APIで、指定した検索条件の商品一覧リンクや、検索結果の商品データを取得するには、ItemSearchオペレーションを利用します。

今回は、そのItemSearchオペレーションで指定するリクエストパラメータについてのまとめとなります。

ItemSearchオペレーションのリクエストパラメータについて

以下、ItemSearchオペレーションを利用する際に指定するリクエストパラメータについてのまとめとなります。

パラメータOperation・SearchIndexを指定

Amazon PA-APIで、ItemSearchオペレーションを利用するには、パラメータOperationの値にItemSearchを指定し、パラメータSearchIndexの値に取得する商品のカテゴリーを指定します。

また、SearchIndexに指定できる値は、国によって異なりますが、以下は、日本のAmazonでSearchIndexの値に指定できる商品のカテゴリーとなります。

SearchIndexの値に指定できる商品カテゴリー

  • All(すべての商品)
  • Apparel(衣服)
  • Automotive(自動車)
  • Baby(赤ちゃん)
  • Beauty(美容)
  • Blended(ブレンド)
  • Books(本)
  • Classical(クラシック)
  • DVD(DVD)
  • Electronics(エレクトロニクス)
  • ForeignBooks(外国の本)
  • Grocery(食料品)
  • HealthPersonalCare(健康パーソナルケア)
  • Hobbies(趣味)
  • HomeImprovement(家の修繕)
  • Jewelry(宝石)
  • Kitchen(キッチン)
  • Music(ミュージック)
  • MusicTracks(ミュージックトラック)
  • OfficeProducts(オフィス用品)
  • Shoes(靴)
  • Software(ソフトウェア)
  • SportingGoods(スポーツ用品)
  • Toys(おもちゃ)
  • VHS(VHS)
  • Video(ビデオ)
  • VideoGames(ビデオゲーム)
  • Watches(時計)

SearchIndexの値によって、商品データを絞り込むパラメータを指定

ItemSearchオペレーションでは、取得する商品データを絞り込むために、上記、SearchIndexの値によって、次のパラメータを1つ以上指定する必要があります。

  • Actor
  • Artist
  • AudienceRating
  • Author
  • Brand
  • BrowseNode
  • City
  • Composer
  • Conductor
  • Director
  • Keywords
  • Manufacturer
  • MusicLabel
  • Neighborhood
  • Orchestra
  • Power
  • Publisher
  • TextStream
  • Title

商品データを絞り込み・並べ替えるパラメータ

ItemSearchオペレーションでは、上記パラメータ以外にも、取得する商品データを絞り込み・並び替えをするパラメータが多数あります。

ItemSearchオペレーションで指定できるパラメータの詳細については、以下のリンク先を参考にしてみてください。

ItemSearch|Product Advertising API

商品を並び替えるSortパラメータについて

パラメータの中に、商品を並び替えるパラメータのSortがありますが、そのパラメータはSearchIndexの値によって、利用できない場合や、指定できる値が異なる場合があります。(また、国によっても異なります)

詳しくは、以下のリンク先を参考にしてみてください。

JP サイトの並べ替え値|Product Advertising API

「SearchIndexの値」と「パラメータ」の組み合わせ

パラメータSearchIndexの値によっては、同時に利用できないパラメータもあります。

以下、よく利用するパラメータと、組み合わせて利用できるSearchIndexの値の表となります。

パラメータ SearchIndexの値
BrowseNode All、Blended 以外は利用可能
Condition All、Blended、Merchants 以外は利用可能
Keywords すべて利用可能
MaximumPrice All、Blended、Merchants 以外は利用可能
MerchantId All、Blended、Merchants 以外は利用可能
MinimumPrice All、Blended、Merchants 以外は利用可能
Title All、Blended、Merchants 以外は利用可能

その他のパラメータの組み合わせについては、以下のリンク先を参考にしてみてください。

SearchIndex-ItemSearch パラメータの組合せ (JP)|Product Advertising API

参考サイトなど

コメント投稿またはTwitterで返信

コメントは、以下の項目(*は必須項目)を入力し「コメントを送信」ボタンから送信お願いします。メールアドレスは公開されることはありません。
Twitterで返信する場合はこちらから。

また、コメントは承認制となります。