Sales Estimation
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.
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:
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.
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.
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:
Rainforest supports retrieving sales estimations for the following Amazon domains.
|
---|
|
|
|
|
|
|
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 . Note the sales_estimation_category parameter is case-sensitive. |
Next Steps Sales Estimation Results Sales Estimation Categories