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

Find Similar Items

The following request uses the Similarity operation with the Small response group. The request finds items similar to ASIN B000W7JWUA (Settlers of Catan board game).

Example Request

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService &Operation=SimilarityLookup &ResponseGroup=Small &IdType=ASIN &ItemId=B000W7JWUA &AssociateTag=[Your_AssociateTag] &AWSAccessKeyId=[Your_AWSAccessKeyId] &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request_Signature]

Example Response

The following response returns three similar items.

Copy
<Item> <ASIN>B000W7JWYG</ASIN> <DetailPageURL> https://www.amazon.com/Settlers-Catan-Player-Extension/dp/B000W7JWYG%3FAWSAccessKeyId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB000W7JWYG </DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>The Settlers of Catan 5 and 6 Player Extension</Title> </ItemAttributes> </Item> <Item> <ASIN>B000W7G78A</ASIN> <DetailPageURL> https://www.amazon.com/MayFair-Games-MFG3063-Catan-Seafarers/dp/B000W7G78A%3FAWSAccessKeyId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB000W7G78A </DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan: Seafarers Game Expansion</Title> </ItemAttributes> </Item> <Item> <ASIN>B000W7I7EW</ASIN> <DetailPageURL> https://www.amazon.com/Catan-Cities-Knights-Game-Expansion/dp/B000W7I7EW%3FAWSAccessKeyId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB000W7I7EW </DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan: Cities and Knights Game Expansion</Title> </ItemAttributes> </Item>

Example Request

The following request uses the Similarity operation to find items similar to multiple ASINs in the request.

When the SimilarityType parameter is set to Random, items are picked randomly from all similar items. Repeating the operation can return different results.

Copy
http://webservices.amazon.com/onca/xml? Service=AWSECommerceService &Operation=SimilarityLookup &ResponseGroup=Small &ItemId=B000W7JWYG,B000W7G78A,B000W7I7EW &SimilarityType=Random &AssociateTag=[Your_AssociateTag] &AWSAccessKeyId=[Your_AWSAccessKeyId] &Timestamp=[YYYY-MM-DDThh:mm:ssZ] &Signature=[Request_Signature]

Example Response

The following response returns five similar items.

Copy
<Item> <ASIN>B00F1BWZBA</ASIN> <DetailPageURL>https://www.amazon.com/Catan-Scenarios-Helpers-of/dp/B00F1BWZBA%3FSubscriptionId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB00F1BWZBA</DetailPageURL> <ItemAttributes> <Manufacturer>Flat River Group</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan Scenarios Helpers of Catan</Title> </Item> <Item> <ASIN>B003NX73F6</ASIN> <DetailPageURL>https://www.amazon.com/Catan-Histories-Settlers-America-Trails/dp/B003NX73F6%3FSubscriptionId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB003NX73F6</DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan Histories: Settlers of America Trails to Rails</Title> </ItemAttributes> </Item> <Item> <ASIN>B009B5GYP0</ASIN> <DetailPageURL>https://www.amazon.com/Mayfair-Games-MFG-73002-Catan/dp/B009B5GYP0%3FSubscriptionId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB009B5GYP0</DetailPageURL> <ItemAttributes> <Manufacturer>Flat River Group</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan: Family Edition</Title> </ItemAttributes> </Item> <Item> <ASIN>B000W7JX9U</ASIN> <DetailPageURL>https://www.amazon.com/Catan-Seafarers-Player-Extension-Edition/dp/B000W7JX9U%3FSubscriptionId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB000W7JX9U</DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan: Seafarers 5&6 Player Extension 4th Edition</Title> </ItemAttributes> </Item> <Item> <ASIN>B000W7G78A</ASIN> <DetailPageURL>https://www.amazon.com/Catan-Seafarers-Game-Expansion-Edition/dp/B000W7G78A%3FSubscriptionId%3D[Your_AWSAccessKeyId]%26tag%3D[Your_AssociateTag]%26linkCode%3Dxm2%26camp%3D2025%26creative%3D165953%26creativeASIN%3DB000W7G78A</DetailPageURL> <ItemAttributes> <Manufacturer>Mayfair Games</Manufacturer> <ProductGroup>Toy</ProductGroup> <Title>Catan: Seafarers Game Expansion 4th Edition</Title> </ItemAttributes> </Item>