The ItemLookup operation enables you to retrieve catalog information for up to ten products or restaurants (US only). It provides access to customer reviews, variations, product similarities, pricing, availability, images, product accessories, and other information.
ItemLookup is available in all of the locales.
Using ItemLookup (REST)
The following ItemLookup example demonstrates a request for item information for an ASIN.
http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&AWSAccessKeyId=[Your Access Key ID Here]
&Operation=ItemLookup
&ItemId=[An ASIN]
Request parameters specify the terms of your request and control the output data that is returned to you.
You must include the required parameters in every request.
ItemLookup accepts the optional parameters that are common to all operations:
The following parameters are specific to the ItemLookup operation:
| Parameter | Description | Required? | Value |
|---|---|---|---|
| Operation |
The operation |
Always Required | ItemLookup |
| ItemId |
Product(s) you would like information about. You may specify up to ten IDs using a comma-separated list (REST) or multiple elements (SOAP). By default the item IDs are assumed to be ASINs, unless you specify the IdType parameter. |
Always Required |
|
| IdType |
Type of product ID you are requesting information about. SKU requires a MerchantId. US only. UPC is US only. EAN is the same as JAN (Japanese article number), so you may use this parameter to look up items by JAN or EAN. DE/JP/CA only. If you select SKU, UPC, or EAN as the IdType for your request, you also need to include the SearchIndex parameter. |
Required for SKU, UPC or EAN search |
Default Value
Valid Values
|
| SearchIndex |
The Amazon store to search. Do not use this parameter with ASIN searches; an error will be returned. SearchIndex is required any time you select SKU, UPC, or EAN as the IdType for your request. The list of available SearchIndex values, segmented by locale, can be found on the search index values page. If IdType is set to EAN, SearchIndex is restricted to a select group of values by locale (Amazon.de and Amazon.co.jp). |
Required for UPC, SKU or EAN searches |
Valid Values:
Amazon.de EAN Valid Values:
Amazon.co.jp EAN Valid Values:
|
| MerchantId |
Filter the list of offerings returned by ItemLookup by the merchant offering the product. If not specified, Amazon is assumed to be the merchant for all requests. Setting MerchantId to "All" returns pricing information for Amazon and all other vendors. US only: You may also use the value "Featured," in which case Amazon E-Commerce Service (ECS) returns the same merchant that is displayed when you click the "Add to Shopping Cart" button on the product detail page. Make sure to use a Merchant ID and not a Seller ID for the value of MerchantId. Seller IDs are not supported. US only: MerchantId must be used with the response groups Variations, VariationMinimum, and/or VariationSummary. |
Required for SKU search; otherwise optional |
Default Value:
Valid Values:
|
| Condition |
Filter the offers returned in the product list by condition type. |
Always Optional |
Default Value
Valid Values
|
| DeliveryMethod |
US only. Filter offers returned in the product list by delivery method. Valid values are Ship and ISPU (In-store pickup). If you use ISPU, the ISPUPostalCode parameter must be included to complete the request. |
Always Optional |
Default Value
Valid Values
|
| ISPUPostalCode |
US only. If DeliveryMethod is set to ISPU, ISPUPostalCode must specify the postal code where in store pickup is requested. |
Required with DeliveryMethod |
Valid Value:
|
| OfferPage |
ItemLookup returns up to 10 offer results at a time. If you do not include OfferPage in your request, the first page (the first 10 offers or all of the offers if there are less than 10 available) are returned by default. If included, this parameter specifies what page of results to include where 1 indicates the first ten results, 2 indicates the the eleventh through twentieth result, etc. |
Always Optional |
Default Value:
Valid Values:
|
| ReviewPage |
ItemLookup returns up to 5 product reviews at a time. If you do not include ReviewPage in your request, the first page (the first five reviews, or all of the reviews if less than five are available) are returned by default. If included, this parameter specifies what page of results to include where 1 indicates the first five results, 2 indicates the the sixth through tenth result, etc. |
Always Optional |
Default Value:
Valid Values:
|
| ReviewSort |
Specifies the order in which Reviews are sorted in the return. |
Always Optional |
Default Value:
Valid Values:
|
| VariationPage |
ItemLookup returns all of the variations for a product. You can optionally include the VariationPage in your request to return 10 variations at a time where 1 indicates the first ten results, 2 indicates the the eleventh through twentieth result, etc. |
Always Optional |
Default Value:
Valid Values:
|
| ResponseGroup |
Controls the data returned by the operation. Use this parameter to specify which response group(s), or group(s) of data elements, you would like ECS to return to you. You can specify as many response groups as you wish using a comma-separated list (REST) or multiple elements (SOAP). |
Always Optional |
Default Values Valid Values |
The ReviewSort parameter enables you to specify the order in which reviews are sorted in responses. The options include:
-HelpfulVotes—Sorted by most helpful reviews listed first.
HelpfulVotes—Sorted by most helpful reviews listed last.
-OverallRating—Sorted by best overall reviews listed first.
OverallRating—Sorted by best overall reviews listed last.
-SubmissionDate (Default)—Sorted by the most recent reviews listed first.
SubmissionDate#8212;Sorted by the most recent reviews listed last.