Stock Estimation

5min

Stock Estimation Parameters
﻿GET  /request
The Stock Estimation Parameters are applicable when making a request with  type=stock_estimation  to retrieve stock level and related information from the shopping cart for a single product on Amazon - the product is specified using the  asin  parameter. The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.
Stock level data is retrieved from the shopping cart page for a single product on Amazon.
Stock for a Specific Seller Offer
By default a Stock Estimation request will return data for the  buybox winning offer  for the passed ASIN.
To return stock estimation for a specific seller offer, rather than the buybox winner, you should pass the  offer_id , retrieved from a  type=offers  offers request, in the stock estimation request's  offer_id  parameter.
Note that  offer_id 's are dynamic, and change over time, so it is recommended that you run your  type=offers  request to retrieve the  offer_id  directly before your stock estimation request.
Products that Require Login
For some ASINs Amazon will require the user to be logged in to their Amazon account to add the product to the cart.
In these instances Rainforest will be unable to provide stock estimation data. You can determine whether this is the case by inspecting the  stock_estimation.requires_login = true  property of the response.
Stock Estimation Page
﻿
For example to request stock-estimation data 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=stock_estimation&amazon_domain=amazon.com&asin=B073JYC4XM
https://api.rainforestapi.com/request?api_key=demo&type=stock_estimation&amazon_domain=amazon.com&asin=B073JYC4XM
﻿
﻿
Stock Estimation Parameters
The following parameters are available for all requests made when  type=stock_estimation .
Parameter
Required
Description
amazon_domain
optional
The Amazon domain on which to perform the stock estimation for the product specified in the asin parameter. For a full list of supported Amazon domains see Supported Amazon Domains .
asin
optional
The Amazon ASIN (product ID) to perform the stock estimation on. Used in combination with the amazon_domain parameter.
offer_id
optional
By default a Stock Estimation request will return data for the buybox winning offer for the passed ASIN.  
To return stock estimation for a specific seller offer, rather than the buybox winner, you should pass the offer_id , retrieved from a type=offers offers request, in the stock estimation request's offer_id parameter. Note that offer_id 's are dynamic, and change over time, so it is recommended that you run your type=offers request to retrieve the offer_id directly before your stock estimation request.
﻿
Next Steps
     Stock Estimation Results﻿

Parameter	Required	Description
amazon_domain	optional	The Amazon domain on which to perform the stock estimation for the product specified in the asin parameter. For a full list of supported Amazon domains see Supported Amazon Domains .
asin	optional	The Amazon ASIN (product ID) to perform the stock estimation on. Used in combination with the amazon_domain parameter.
offer_id	optional	By default a Stock Estimation request will return data for the buybox winning offer for the passed ASIN. To return stock estimation for a specific seller offer, rather than the buybox winner, you should pass the offer_id , retrieved from a type=offers offers request, in the stock estimation request's offer_id parameter. Note that offer_id 's are dynamic, and change over time, so it is recommended that you run your type=offers request to retrieve the offer_id directly before your stock estimation request.

Updated 11 Aug 2024

Did this page help you?

Offers

Sales Estimation