Sales Estimation

sales estimation parameters get get /request the sales estimation parameters are applicable when making a request with type=sales estimation to retrieve estimated sales information for a single product on amazon important info on sales estimates rainforest uses an internal algorithm which uses signals from an asin's product page, bestseller rank, reviews, search result rankings and known sales datapoints to generate estimated weekly and monthly unit sales volumes rainforest sales estimations should be used as indications of likely sales volumes they are not an exact science and are best used in an application that requires a broad steer on the likely sales volume for a given asin rainforest provides no warranty as to the accuracy of the sales estimation figures, or the fitness for purpose for any given use case they should be used at your own risk note that for some products, typically those with a very low bestseller rank, where insufficient data is available for rainforest to confidently make a sales estimation prediction, then no sales estimation result will be returned there are two ways to specify a sales estimation request you can either supply asin and amazon domain parameters or, if you require a more generic sales estimation based on a theoritical product of a certain bestseller rank within a top level amazon category, you can supply bestseller rank , sales estimation category and amazon domain parameters these two methods are described in detail below method 1 sales estimation for a specific asin if you know the asin of the product you wish to retrieve sales estimations for you can specify your sales estimation request using the asin and amazon domain parameters for example, to request sales estimation for asin b07gy4ds42 on amazon com the rainforest request would be http https //api rainforestapi com/request?api key=demo\&type=sales estimation\&amazon domain=amazon com\&asin=b07gy4ds42curl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="sales estimation" \\ d amazon domain="amazon com" \\ d asin="b07gy4ds42"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "sales estimation", amazon domain "amazon com", asin "b07gy4ds42" } // 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' 'sales estimation', 'amazon domain' 'amazon com', 'asin' 'b07gy4ds42' } \# 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' => 'sales estimation', 'amazon domain' => 'amazon com', 'asin' => 'b07gy4ds42' ]); \# 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; ?> when specifying your request using the asin and amazon domain parameters rainforest performs the following actions retrieves the bestseller rank ( 2 in the example below) and top level amazon category ( appliances in the example below) from the product detail page for the specified asin uses the retrieved bestseller rank and top level amazon category to perform a sales estimation prediction note if it is not possible to retrieve the bestseller rank from the product page (for example, because it is not shown) rainforest will not return a sales estimation method 2 sales estimation for an arbitrary bestseller rank if you don't known the asin of the product you want to retrieve sales estimation for, or you just wish to retrieve a sales estimation based purely on bestseller rank, you can specify your sales estimation request using the bestseller rank , sales estimation category and amazon domain parameters this will cause rainforest to return a sales estimation based data from other products with a similar bestseller rank in the same top level amazon category to view the avaialble top level amazon categories that can be used with the sales estimation category parameter see the sales estimation categories reference https //docs trajectdata com/rainforestapi/product data api/reference/sales estimation category names for example, to request sales estimation for bestseller rank 5 , for top level amazon category pet supplies on amazon com the rainforest request would be http https //api rainforestapi com/request?api key=demo\&type=sales estimation\&bestseller rank=5\&sales estimation category=pet+supplies\&amazon domain=amazon comcurl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="sales estimation" \\ d bestseller rank="5" \\ d sales estimation category="pet supplies" \\ d amazon domain="amazon com"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "sales estimation", bestseller rank "5", sales estimation category "pet supplies", amazon domain "amazon com" } // 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' 'sales estimation', 'bestseller rank' '5', 'sales estimation category' 'pet supplies', 'amazon domain' 'amazon com' } \# 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' => 'sales estimation', 'bestseller rank' => '5', 'sales estimation category' => 'pet supplies', 'amazon domain' => 'amazon com' ]); \# 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; ?> supported amazon domains rainforest supports retrieving sales estimations for the following amazon domains canada france germany india italy mexico spain united kingdom united states sales estimation parameters the following parameters are available for all requests made when type=sales estimation parameter required description amazon domain optional the amazon domain to retrieve sales estimations from asin optional the amazon asin (product id) to retrieve a sales estimation for please review the method 1 documentation above for the behaviour rainforest enacts in response to an asin being supplied in a sales estimation request when using the asin parameter the amazon domain parameter is also required bestseller rank optional an arbitrary bestseller rank to retrieve sales estimation data for must be used in combination with the sales estimation category and amazon domain parameters please review the method 2 documentation above for the behaviour rainforest enacts in response to a bestseller rank being supplied in a sales estimation request sales estimation category optional the top level amazon category to retrieve sales estimation data from must be used in combination with the bestseller rank and amazon domain parameters please review the method 2 documentation above for the behaviour rainforest enacts in response to a sales estimation category being supplied in a sales estimation request note for a list of valid sales estimation category values, per amazon domain, review the sales estimation categories reference https //docs trajectdata com/rainforestapi/product data api/reference/sales estimation category names note the sales estimation category parameter is case sensitive next steps sales estimation results https //docs trajectdata com/rainforestapi/product data api/results/sales estimation sales estimation categories https //docs trajectdata com/rainforestapi/product data api/reference/sales estimation category names