Menu
Product Advertising API
Developer Guide (API Version 2013-08-01)

SimilarityLookup

When you specify an item ID in a SimilarityLookup request, the response returns similar items. You can use the Similarities response group to return similar results. However, the SimilarityLookup operation has the following advantages:

  • The operation provides a number of request parameters, such as Condition, to filter the response.

  • You can specify many response groups to customize the information in the response.

  • You can specify more than one item in a request and find items that are similar to all of them, or similar to each item in the request.

The following request returns items similar to the specified ASIN.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate Tag]& Operation=SimilarityLookup& ItemId=[ASIN] &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

The following response snippet shows one found item, Mark VII Men's Short Sleeve Knit Golf Shirt, is similar to the ASIN specified in the request.

Copy
<Item> <ASIN>B0009VX8VI</ASIN> <ItemAttributes> <ProductGroup>Apparel</ProductGroup> <Title>Mark VII Men's Short Sleeve Knit Golf Shirt</Title> </ItemAttributes> </Item>

Specify Multiple Items

The following request is a SimilarityLookup operation that specifies multiple items in a request.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate Tag]& Operation=SimilarityLookup& ItemId=ASIN1,ASIN2,ASIN3 &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request Signature]

To specify how similar items are returned, set the value of the SimilarityType parameter. The following values are accepted:

Intersection

Items returned are similar to all items specified in the request. This is the default value.

Random

The items returned are similar to at least one of the items specified in the request.


                        See the example intersection.

The second value is called Random because the items returned are randomly chosen from all similar items found. The operation can return up to ten similar items. It's possible there are more than ten similar items, and identical SimilarityLookup requests can return different similar items.

It's also possible similar items are not returned. If similar items can't be found, a response error is returned.

Copy
<Error> <Code>AWS.ECommerceService.NoSimilarities</Code> <Message>There are no similar items for this ASIN: B000B776KY. </Message> </Error>

An empty result is more likely when the SimilarityType value is Intersection.

Filter for Similar Items Sold by Amazon

The SimilarityLookup operation can restrict items returned with the MerchantId parameter. Set the value to Amazon to specify similar items sold by Amazon. This parameter is optional in SimilarityLookup requests.