Sales Estimation

3min

Sales Estimation Results
When making a request with the  type  parameter set to  type=sales_estimation  Rainforest API will return estimated sales for the given  asin  or  bestseller_rank .
For full details of how Rainforest sales estimations are constructed and the methodology behind them please review the sales estimation parameters.
An example of the JSON object returned from a Sales Estimation request is shown below:
JSON
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "763fc1a4b3eb053f5c8f20f12655b09dfd36130d",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1
  },
  "request_parameters": {
    "type": "sales_estimation",
    "asin": "B07GY4DS42",
    "amazon_domain": "amazon.com"
  },
  "sales_estimation": {
    "has_sales_estimation": true,
    "monthly_sales_estimate": 7921,
    "weekly_sales_estimate": 1980,
    "bestseller_rank": 2,
    "sales_estimation_category": "Appliances"
  }
}
{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "763fc1a4b3eb053f5c8f20f12655b09dfd36130d",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1
  },
  "request_parameters": {
    "type": "sales_estimation",
    "asin": "B07GY4DS42",
    "amazon_domain": "amazon.com"
  },
  "sales_estimation": {
    "has_sales_estimation": true,
    "monthly_sales_estimate": 7921,
    "weekly_sales_estimate": 1980,
    "bestseller_rank": 2,
    "sales_estimation_category": "Appliances"
  }
}
﻿
Note  if it is not possible for Rainforest to retrieve a sales estimation for a given  asin  or  bestseller_rank  request parameter (for example, because the product is ranked very low and Rainforest does not have sufficient data to perform a prediction) then no sales estimation will be returned.
Rainforest API returns the following properties for Sales Estimation requests:
Property
Type
Description
sales_estimation
object
Sales Estimation Object 
An object containing the sales estimation result.
monthly_sales_estimate
string
The estimated monthly unit sales of the asin or bestseller_rank specified in the sales estimation request. For details of the methodology Rainforest usees in generating sales estimations please review the sales estimation parameters .
﻿
weekly_sales_estimate
string
The estimated weekly unit sales of the asin or bestseller_rank specified in the sales estimation request. For details of the methodology Rainforest usees in generating sales estimations please review the sales estimation parameters .
﻿
bestseller_rank
string
The bestseller rank used by Rainforest in generating the sales estimation data.
﻿
sales_estimation_category
string
The sales estimation category used to perform the sales estimation prediction. Sales estimation categories are the top-level Amazon category that the given asin ranks in. For a full list of sales estimation categories see the sales estimation categories reference .
﻿
has_sales_estimation
boolean
True / false depending on whether sufficient data exists for Rainforest to generate a sales estimation. Rainforest sales estimation works using an internal algorithm utilizing signals from an ASIN's product page, bestseller rank, reviews, search result rankings and known sales datapoints to generate estimated weekly and monthly sales volumes. Rainforest must have sufficient datapoints available in order to generate a sales estimation.
﻿
message
string
Where has_sales_estimation=false then message contains an full-text explaination of why a sales estimation was not available for the given request parameters.
﻿
Next Steps
     Sales Estimation Parameters
     Sales Estimation Categories﻿

Property	Type	Description
sales_estimation	object	Sales Estimation Object An object containing the sales estimation result. monthly_sales_estimate string The estimated monthly unit sales of the asin or bestseller_rank specified in the sales estimation request. For details of the methodology Rainforest usees in generating sales estimations please review the sales estimation parameters . weekly_sales_estimate string The estimated weekly unit sales of the asin or bestseller_rank specified in the sales estimation request. For details of the methodology Rainforest usees in generating sales estimations please review the sales estimation parameters . bestseller_rank string The bestseller rank used by Rainforest in generating the sales estimation data. sales_estimation_category string The sales estimation category used to perform the sales estimation prediction. Sales estimation categories are the top-level Amazon category that the given asin ranks in. For a full list of sales estimation categories see the sales estimation categories reference . has_sales_estimation boolean True / false depending on whether sufficient data exists for Rainforest to generate a sales estimation. Rainforest sales estimation works using an internal algorithm utilizing signals from an ASIN's product page, bestseller rank, reviews, search result rankings and known sales datapoints to generate estimated weekly and monthly sales volumes. Rainforest must have sufficient datapoints available in order to generate a sales estimation. message string Where has_sales_estimation=false then message contains an full-text explaination of why a sales estimation was not available for the given request parameters.

Updated 16 Aug 2024

Did this page help you?

Stock Estimation

Reviews v2