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.
SimilarityLookup is available in all of the locales.
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]
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:
|
| 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:
Valid Values:
|
| 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:
|
|
| Condition |
Use the Condition parameter to filter the offers returned in the product list by condition type. |
Always Optional |
Default Value
Valid Values
|
| 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
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). |
Optional |
Default Values Valid Values |