SimilarityLookup Operation

Description

The SimilarityLookup operation allows you to retrieve products that are similar to one or several specific Amazon products. SimilarityLookup may also be used to retrieve an intersection of similar products for up to ten specific Amazon products.

Availability

SimilarityLookup is available in the following locales: US (Amazon.com), JP (Amazon.co.jp), DE (Amazon.de), and UK (Amazon.co.uk).

Sample Request | Parameters

Sample Request

Using SimilarityLookup (REST)

The following example demonstrates a SimilarityLookup request for a specific ASIN.

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService&SubscriptionId=[Your
Subscription ID
Here]&Operation=SimilarityLookup&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.

SimilarityLookup accepts the optional parameters that are common to all operations:

The following parameters are specific to the SimilarityLookup operation:

Parameter Description Required? Value
Operation The operation. Always Required SimilarityLookup
ItemId

The product(s) that you want similarities for.

Always Required

Valid Values:

  • Up to ten ASINs in a comma-separated list for REST requests or in multiple ItemId elements for SOAP requests.
SimilarityType

Use the SimilarityType parameter to filter the list of similar products returned by SimilarityLookup. Note that the SimilarityType parameter is ignored when when the SimilarityLookup request contains only one ItemId.

Set the value of SimilarityType to Intersection if you want the list of similar products returned by SimilarityLookup to include only products that are similar to all of the items in the request.

Set the value of SimilarityType to Random if you want the list of similar products returned by SimilarityLookup to include an assortment of similar products corresponding to any of the items in the request.

Always Optional

Default Value:

  • Intersection

Valid Values:

  • Intersection

  • Random

MerchantId

Filter the list of offerings returned by SimilarityLookup 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.

US only: MerchantId must be used with the response groups Variations, VariationMinimum, and/or VariationSummary.

 

Valid Values:

  • Amazon (the Default value)

  • All

  • Featured

  • A Merchant ID
Condition

Use the Condition parameter to filter the offers returned in the product list by condition type.

Always Optional

Default Value

  • New

Valid Values

  • All

  • New

  • Used

  • Refurbished

  • Collectible

DeliveryMethod

Use the DeliveryMethod parameter to filter offers returned in the product list by delivery method. Valid values are Ship and ISPU (In-store pickup). If you use ISPU, the offers returned will be ISPU offers from any postal code. To get ISPU offers from a specific postal code, you must use the ItemLookup operation.

US only.

Always Optional

Default Value

  • Ship

Valid Values

  • Ship

  • ISPU

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).

 Optional

Default Values

Valid Values
[ back to top ]