ItemLookup

説明

商品IDを指定すると、 ItemLookup オペレーションは、リクエストで指定したレスポンスグループに従って、一部または全ての商品属性が返します。デフォルトでは、 ItemLookup は商品のASIN, DetailPageURL, Manufacturer, ProductGroup および Title を返します。

ItemLookup は、多数のレスポンスグループをサポートしています。このため、商品レビュー、バリエーション、類似品、価格、在庫状況、商品画像、アクセサリなど、商品属性と呼ばれるさまざまな情報を取得できます。

複数の商品を一度に検索するには、商品IDをカンマで区切ります。

利用可能なサイト

全ての国のサイト。ただし、パラメータのサポートは各国のサイトごとに異なります。

リクエストパラメータ

名前説明必須
Condition

商品のコンディションを指定します。Condition が "All" に設定されている場合、Condition の有効な値に対して個々のレスポンスセットが返されます。デフォルト値は "New" です( "All" ではありません)。リクエストで結果が何も返されない場合は、値を "All" に設定してみてください。値が "New" の場合、ItemSearch の Availability パラメータに "Available" を設定することはできません。Amazonでは、"New" の商品だけを販売しています。

タイプ: 文字列

デフォルト: New

有効な値: Used | Collectible | Refurbished | All

いいえ
IdType

商品の検索に使う商品IDの種類。全ての IdTypes (ASINxを除く) では、SearchIndexを指定する必要があります。SKUでは、MerchantIdも指定する必要があります。詳細については、商品ID をご参照ください。

タイプ: 文字列

デフォルト: ASIN

有効な値: SKU | UPC | EAN | ISBN (US のみで、サーチインデックスが Books の場合有効) | JAN. UPCはCAサイトでは無効です。

いいえ
ItemId

商品を一意に識別する1~10の整数。数値の意味はIdType で指定します。 つまり、IdType が ASIN の場合、ItemId の値は ASIN になります。もし ItemId が ASIN の場合、サーチインデックスをリクエストで指定することはできません。

タイプ: 文字列

デフォルト: なし

有効な値: 有効な商品ID。カンマで区切ったリストを使用することで、最大10までIDを指定できます。

はい
MerchantId

商品を出品しているマーチャントを指定します。MerchantIdは Amazon がマーチャントに割り当てた半角英数字の ID です。デフォルト値は "Amazon" です。リクエストで結果が何も返されない場合は、値を "All" に設定してみてください。

出品者 ID ではなく必ずマーチャント ID を使用してください。出品者 ID はサポートされていません。

タイプ: 文字列

デフォルト: Amazon

有効な値: MerchantId--マーチャントのID | All--Amazonとその他全てのマーチャント | Featured-- "ショッピングカートに入れる" をクリックしたときに表示されるマーチャント

いいえ
OfferPage

ItemLookupによって返される出品情報のページ。各ページに10点の出品商品があります。例えば、11~20の出品情報を調べるには、OfferPage に2を設定します。

タイプ: 文字列

デフォルト: 1

有効な値: 1~ 100までの整数

いいえ
RelatedItemsPage このオプションパラメータは、RelatedItemsレスポンスグループを使用する場合にのみ有効です。各 ItemLookup リクエストは、最大で10個の関連商品を返します。RelatedItemsPage の値には、受け取りたい関連商品の10のセットを指定します。例えば、値に 2を指定すると、10個ずつひとまとまりとした場合の2番目の関連商品を返します。 いいえ
RelationshipType このパラメータは、RelatedItemsレスポンスグループを使用する場合に必要です。受け取りたい関連商品の種類がRelationshipType パラメータで指定されます。値の例としては、Episode、Season、Tracks があります。 全てのタイプの一覧については、 関連商品のタイプ をご参照ください。

制約: RelatedItems レスポンスグループを使用する場合は必須です。

はい
ReviewPage

ItemLookupによって返されるレビューのページ番号。各ページに5件のレビューが表示されます。例えば、6~10番目のレビューを読むには、ReviewPageに2を設定します。

タイプ: 文字列

デフォルト: 1

有効な値: 1~ 20までの整数

いいえ
ReviewSort

返されるレビューの並べ替え順序を指定します。詳細については、 レビューの並べ替え をご参照ください。

タイプ: 文字列

デフォルト: -SubmissionDate

有効な値: -HelpfulVotes | HelpfulVotes | -OverallRating | OverallRating | SubmissionDate

いいえ
SearchIndex

検索対象の商品カテゴリ。

タイプ: 文字列

デフォルト: なし

有効な値: サーチインデックス名。例えば、Apparel, Beauty, Blended, Books などです。 サーチインデックスの一覧については、 国ごとに使用可能なサーチインデックス をご参照ください。

制約: ItemId が ASIN の場合、サーチインデックスをリクエストで指定することはできません。ItemId が ASIN 以外の場合は必須

条件付き
TagPage

返される結果のページを指定します。各ページに10件の結果が表示されます。

タイプ: 整数

タイプ: 文字列

デフォルト: なし

制約: 最大ページ数は 400ページです。

いいえ
TagsPerPage

指定された商品に関連して返されるタグの数。

タイプ: 整数

タイプ: 文字列

デフォルト: なし

いいえ
TagSort

結果の並べ替え順序を指定します。

タイプ: 文字列

デフォルト: - Usages

有効な値:

  • FirstUsed-商品が最初に使用された日付を基準に並べ替え

    - FirstUsed

  • LastUsed-商品が最後に使用された日付を基準に並べ替え

    - LastUsed

  • Name-アルファベットのAからZの順

    - Name

  • Usages-商品の使用頻度が低い順

商品を降順に並べ替えるには、値の先頭にマイナス記号(-)を付けます。

いいえ
VariationPage

ItemLookupによって返されるバリエーションのページ番号。 デフォルトでは、 ItemLookup は全てのバリエーションを返します。レスポンスのサブセクションを返すには VariationPage を使用します。各ページに10個のバリエーションがあります。例えば、11~20の出品情報を調べるには、VariationPage に2を設定します。

タイプ: 文字列

デフォルト: All

有効な値: 1~ 150までの整数

いいえ
ResponseGroup

返される値の種類を指定します。1つのリクエストに複数のレスポンスグループをカンマで区切って指定できます。

有効な値: Accessories | BrowseNodes | EditorialReview | Images | ItemAttributes | ItemIds | Large | ListmaniaLists | Medium | MerchantItemAttributes | OfferFull | Offers | PromotionDetails | PromotionSummary | OfferSummary| RelatedItems | Reviews | SalesRank | Similarities | Subjects | Tags | TagsSummary | Tracks | VariationImages | VariationMinimum | Variations (US のみ) | VariationSummary

いいえ

ItemLookup には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

レスポンス

名前説明
ASIN Amazon Standard Identification Number の略。Amazon によって割り当てられた、商品を一意に識別する半角英数字の文字列です。
Item DetailPageURL および ASIN, Title, ProductGroup, および、Manufacturer を含む、商品についての情報のコンテナ。
ItemAttributes 商品に関する情報のコンテナ。Title, ProductGroup. およびManufacturer を含む、商品についての情報のコンテナ。
Items 1つまたは複数の商品のコンテナ。
Manufacturer 商品を製造した会社の名前。
ProductGroup 商品のカテゴリー(例: "Book"、"DVD")。完全な商品グループの一覧を参照するには、www.amazon.co.jp を開き、 "すべてのカテゴリーを見る" という文字をクリックしてください。
Title 商品のタイトル。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。

次のリクエストは、ItemId B00008OE6I に関する情報を返します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=B00008OE6I    

このリクエストに対するレスポンスをレスポンス例に示します。

次のリクエストは、Amazon からは出品されていない新品同様の商品の出品情報を返します。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=B00008OE6I&
IdType=ASIN&
ResponseGroup=OfferFull&
Condition=All&
MerchantId=All    

この例では、商品が Amazon から出品されているわけではないため、値としてCondition=All および MerchantId=All または特定マーチャントのIDを指定する必要があります。

次のリクエストでは、ItemIdがSKUであるため、MerchantIdIdTypeも指定する必要があります。A MerchantIdの値が必要なのは、デフォルト値が "Amazon" であり、Amazon によって出品されている商品はSKU値では識別されないためです。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=[SKU]&
MerchantId=[MerchantID]&
IdType=SKU

次のリクエストでは、ItemIdがUPCであるため、SearchIndexおよび、ItemTypeも指定する必要があります。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=[UPC]&
SearchIndex=Books&
&IdType=UPC

次のリクエストでは、ItemIdがEANであるため、SearchIndex および ItemType.も指定する必要があります。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
Operation=ItemLookup&
ItemId=[EAN]&
SearchIndex=Electronics&
IdType=EAN

商品のブラウズノードを検索するには、BrowseNodes レスポンスグループを使用します。

レスポンスで各CDのトラック、タイトル、各トラック番号を検索するには、Tracks レスポンスグループを使用します。

レスポンスで返される類似品のASINとタイトルを検索するには、Similarities レスポンスグループを使用します。

レスポンスで、カスタマーによる商品のレビューと、各商品のレビューの総数を検索するには、Reviews レスポンスグループを使用します。

出品情報の数と、新品、中古商品、コレクター商品、新品同様の商品の各コンディションクラスの最低価格を検索するには、OfferSummary レスポンスグループを使用します。

レスポンスで、アクセサリがある商品ごとにアクセサリのASINとタイトルを検索するには、Accessories レスポンスグループを使用します。

レスポンス例

次のコードは最初のリクエストに対するレスポンスの一部です。デフォルトで返される全ての商品属性が示されています。

<Items>
  <Request>
  <IsValid>True</IsValid> 
  <ItemLookupRequest>
    <ItemId>B00008OE6I</ItemId> 
  </ItemLookupRequest>
  </Request>
  <Item>
    <ASIN>B00008OE6I</ASIN> 
<DetailPageURL>http://www.amazon.com/exec/obidos/redirect?tag=ws%26link_code=xm2%26camp=2025%26creative=165953%26path=http://www.amazon.com/gp/redirect.html%253fASIN=B00008OE6I%2526tag=ws%2526lcode=xm2%2526cID=2025%2526ccmID=165953%2526location=/o/ASIN/B00008OE6I%25253FAWSAccessKeyId=[AWS アクセスキー ID]</DetailPageURL> 
    <ItemAttributes>
    <Manufacturer>Canon</Manufacturer> 
    <ProductGroup>Photography</ProductGroup> 
    <Title>Canon PowerShot S400 4MP Digital Camera w/ 3x Optical Zoom</Title> 
   </ItemAttributes>
  </Item>
</Items>  

関連オペレーション