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
﻿
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:
HTTP
Curl
Node.js
Python
PHP
https://api.rainforestapi.com/request?api_key=demo&type=product&amazon_domain=amazon.com&asin=B073JYC4XM
https://api.rainforestapi.com/request?api_key=demo&type=product&amazon_domain=amazon.com&asin=B073JYC4XM
﻿
﻿
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.
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.
fields
optional
Use the fields param to declare product results you want to include in your result. 
Note: Only allows selecting top level objects and items under product object. product fields should be specified as a comma separated list of field names, with nested fields being expressed in dot notation .
Example: 
fields=product.asin,product.variants
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).
variant_prices
optional
Determines whether Rainforest returns the variants.price as part of the product request. 
Note : When variant_prices=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_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.
include_safety_product_resources
optional
Determines whether Rainforest includes the JSON of the Safety Product Resources: images and contacts section 
Note : When include_safety_product_resources=true 3 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve safety images an contacts).
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.
import_fees
optional
Determines whether Rainforest returns the shipping / import_delivery costs as part of the buybox. 
Note : When import_fees=true 2 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve delivery fee information in the buybox).
﻿
Next Steps
     Product Results﻿

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.
fields	optional	Use the fields param to declare product results you want to include in your result. Note: Only allows selecting top level objects and items under product object. product fields should be specified as a comma separated list of field names, with nested fields being expressed in dot notation . Example: fields=product.asin,product.variants
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).
variant_prices	optional	Determines whether Rainforest returns the variants.price as part of the product request. Note : When variant_prices=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_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.
include_safety_product_resources	optional	Determines whether Rainforest includes the JSON of the Safety Product Resources: images and contacts section Note : When include_safety_product_resources=true 3 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve safety images an contacts).
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.
import_fees	optional	Determines whether Rainforest returns the shipping / import_delivery costs as part of the buybox. Note : When import_fees=true 2 credits are charged instead of 1 for the request (this is due to the increased number of internal requests required to retrieve delivery fee information in the buybox).

Common