Skip to content

Similar Products Response

For the Similar Products operation, result contains the product object: the requested product's basic data and, nested inside it, the similar array of related products. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
└── product
├── asin, title, brand, category
├── image { id, link, variant }
└── similar[]
├── asin, title, brand, category
└── image { id, link, variant }

Result fields

result.product

FieldTypeDescription
asinstringASIN of the requested product.
titlestringProduct title as shown on Amazon, for example Spedal 2026 2-in-1 Wireless CarPlay & Android Auto Adapter.
brandstringBrand name.
categorystringFull category path, with levels separated by /, for example Car & Vehicle Electronics/Vehicle Electronics Accessories.
imageobjectMain image of the product. See image below.
similararraySimilar products. See similar[] below. Empty ([]) when no similar products are found.

image

The same structure is used for result.product.image and for the image object of every item in similar[].

FieldTypeDescription
idstringAmazon image identifier, for example 41J-WgccuxL.
linkstringDirect URL of the image.
variantstringImage variant, for example MAIN.

similar[]

Each item is one product related to the requested ASIN. The array has at most similar_limit items and can have fewer.

FieldTypeDescription
asinstringASIN of the similar product.
titlestringTitle of the similar product.
brandstringBrand name of the similar product.
categorystringFull category path of the similar product, with levels separated by /.
imageobjectMain image of the similar product: id, link, variant.

Sample response

This sample is shortened: the similar array shows two items, //... marks the omitted items, and result.product.title is not shown. Remove the comment before you parse it as JSON.

Sample response (SIMILAR_PRODUCTS, .com)
{
"request_info": {
"id": "f4b33568-4ac0-4762-be68-6c0224f6f291",
"success": true,
"status_code": 200,
"error_details": [],
"credits_used": 15330,
"credit_used_this_request": 1,
"credits_remaining": 1999984670,
"credits_reset_at": "2026-10-17T07:17:40.000Z"
},
"request_parameters": {
"output": "json",
"language": "en_US",
"include_html": false,
"asin": "B0G2V8898X",
"similar_limit": "10",
"type": "SIMILAR_PRODUCTS"
},
"request_metadata": {
"created_at": "2026-10-14T12:46:59.991Z",
"processed_at": "2026-10-14T12:47:00.419Z",
"total_time_taken": 0.428
},
"result": {
"product": {
"asin": "B0G2V8898X",
"brand": "Spedal",
"category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
"image": {
"id": "41J-WgccuxL",
"link": "https://m.media-amazon.com/images/I/41J-WgccuxL.jpg",
"variant": "MAIN"
},
"similar": [
{
"asin": "B0G64V3PVR",
"brand": "OTTOCAST",
"category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
"image": {
"id": "31WBjLekrEL",
"link": "https://m.media-amazon.com/images/I/31WBjLekrEL.jpg",
"variant": "MAIN"
},
"title": "OTTOCAST Mini Edge 2-in-1 Wireless CarPlay & Android Auto Adapter 2026"
},
{
"asin": "B0HCCY69WS",
"brand": "LAMTTO",
"category": "Car & Vehicle Electronics/Vehicle Electronics Accessories/Audio & Video Accessories",
"image": {
"id": "41FoFyc2ctL",
"link": "https://m.media-amazon.com/images/I/41FoFyc2ctL.jpg",
"variant": "MAIN"
},
"title": "LAMTTO Wireless CarPlay and Android Auto Adapter with Gemini AI YouTube"
},
//...
],
}
}
}

Notes

  • request_parameters.similar_limit is echoed as a string ("10", "50" or "100").
  • request_info.credit_used_this_request shows the credits charged for this call: 1, 6 or 11 depending on similar_limit, or 1 when similar is empty.
  • An ASIN that does not exist in the requested domain returns HTTP 404 and is charged 1 credit. A failed request with no data returns HTTP 504 and is refunded. Always check request_info.success and request_info.error_details.