Core APIs
...
Parameters
Core Requests
Product
4min
product parameters get 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 https //www amazon com/dp/b073jyc4xm 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 https //docs trajectdata com/rainforestapi/product data api/reference/gtin upc ean to asin 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 https //api rainforestapi com/request?api key=demo\&type=product\&amazon domain=amazon com\&asin=b073jyc4xmcurl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="product" \\ d amazon domain="amazon com" \\ d asin="b073jyc4xm"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "product", amazon domain "amazon com", asin "b073jyc4xm" } // make the http get request to rainforest api axios get('https //api rainforestapi com/request', { params }) then(response => { // print the json response from rainforest api console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'type' 'product', 'amazon domain' 'amazon com', 'asin' 'b073jyc4xm' } \# make the http get request to rainforest api api result = requests get('https //api rainforestapi com/request', params) \# print the json response from rainforest api print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'type' => 'product', 'amazon domain' => 'amazon com', 'asin' => 'b073jyc4xm' ]); \# make the http get request to rainforest api $ch = curl init(sprintf('%s?%s', 'https //api rainforestapi com/request', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response from rainforest api echo $api result; ?> 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 https //docs trajectdata com/rainforestapi/product data api/reference/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 https //docs trajectdata com/rainforestapi/product data api/results/product