Core API
...
Product Data API
Parameters

Product

4min

Product Parameters

GET /request

The Product Parameters are applicable when making a request with type=product to retrieve details of a single product on Amazon - the product is specified using either the asin and amazon_domain parameters or the url parameter (where the url parameter contains a link to an Amazon product page). The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.

Product details are retrieved from the product page for a single product on Amazon.

Product Page
Product Page


Lookup an ASIN by GTIN / ISBN / UPC / EAN ASIN Data API can automatically convert GTIN/ISBN/UPC/EAN codes to ASINs and return product data. For details of how to lookup Amazon product details by GTIN/ISBN/UPC/EAN please see refer to the guide.

Note that ASIN Data API will cache the GTIN-to-ASIN mapping for 2 months. To force a new GTIN lookup (for example, if you suspect the existing mapping is stale), use the skip_gtin_cache=true request parameter (note that using skip_gtin_cache=true decrements 2 credits from your balance, instead of 1).

For example, to request details for the ASIN B07WJJF8PB on amazon.com the request would be:

HTTP
Curl
Node.js
Python
PHP



Product Parameters

The following parameters are available for all requests made when type=product .

Parameter

Required

Description

amazon_domain

optional

The Amazon domain to retrieve product details from for the product specified in the asin parameter. For a full list of supported Amazon domains see Supported Amazon Domains .

Note : If the amazon_domain and asin parameters are supplied then the url parameter is ignored.

asin

optional

The Amazon ASIN (product ID) to retrieve product details for. Used in combination with the amazon_domain parameter.

Note : If the asin and amazon_domain parameters are supplied then the url parameter is ignored.

url

optional

The Amazon product-page URL to retrieve product details from.

Ensure that the url parameter is URL-encoded.

Note : If the url parameter is supplied then the amazon_domain and asin parameters are ignored.

gtin

optional

A GTIN, ISBN, UPC or EAN code to retrieve results for. Internally ASIN Data API will first convert the GTIN/ISBN/UPC/EAN to an Amazon ASIN, then retrieve the results for that ASIN from Amazon. Used in combination with the amazon_domain parameter.

Note : If the gtin and amazon_domain parameters are supplied then the url parameter is ignored.

skip_gtin_cache

optional

By default ASIN Data API will cache the GTIN-to-ASIN mapping for 2 months. To force a new GTIN lookup (for example, if you suspect the existing mapping is stale), use the skip_gtin_cache=true request parameter (note that using skip_gtin_cache=true decrements 2 credits from your balance, instead of 1).

include_summarization_attributes

optional

Determines whether ASIN Data API returns the summarization_attributes and customers_say properties as part of the product request. The summarization attributes are displayed next to the product reviews and typically show the rating, out of 5, a product has received for a specific attribute, for example "value for money" or "durability".

When include_summarization_attributes=true a summarization_attributes property containing the summarization attributes, and customers_say property containing the summerization of review themes, is shown in the result.

Note : When include_summarization_attributes=true 2 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve summarization attributes).



Next Steps      Product Results

Updated 11 Aug 2024
Did this page help you?