ItemLookup Operation

Description

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.

Availability

ItemLookup is available in all of the locales.

Sample Request | Parameters

Sample Request

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]
[ back to top ]

Request Parameters

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

  • Product IDs

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

  • ASIN

Valid Values

  • ASIN

  • SKU (US only)

  • UPC (US only)

  • EAN (DE/JP/CA only)

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:

  • A Search Index (varies by locale)

Amazon.de EAN Valid Values:

  • Electronics

  • Music

  • Classical

  • DVD

  • VHS

  • Video

  • OutdoorLiving

  • HealthPersonalCare

  • Kitchen

  • Software

  • SoftwareVideoGames

  • VideoGames

  • Tools

Amazon.co.jp EAN Valid Values:

  • Electronics

  • Music

  • Classical

  • DVD

  • Kitchen

  • Software

  • VideoGames

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:

  • Amazon

Valid Values:

  • All

  • Featured (US only)

  • A Merchant ID (US only)
Condition

Filter the offers returned in the product list by condition type.

Always Optional

Default Value

  • New

Valid Values

  • All

  • New

  • Used

  • Refurbished

  • Collectible

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

  • Ship

Valid Values

  • Ship

  • ISPU (US only)

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:

  • A Postal Code
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:

  • 1

Valid Values:

  • Integers 1 to 100
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:

  • 1

Valid Values:

  • Integers 1 to 20
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:

  • All

Valid Values:

  • All

  • Integers 1 to 150
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
[ back to top ]