Product
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.
Lookup an ASIN by GTIN / ISBN / UPC / EAN Rainforest 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 Rainforest 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 B073JYC4XM on amazon.com the request would be:
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. |
gtin | optional | A GTIN, ISBN, UPC or EAN code to retrieve results for. Internally Rainforest 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 Rainforest 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 Rainforest 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). |
include_a_plus_body | optional | Determines whether Rainforest includes the HTML of the A-Plus description section (typically under the heading "From the manufacturer") in the response. |
include_book_description_raw | optional | Determines whether raw HTML for the book_description is included in the response (this can increase the size of the response). Can be set to true or false (the default). Only applies to ASINs that has a book_description in their response. |
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. |
Next Steps Product Results