Core APIs
...
Results
Sales & Stock

Stock Estimation

4min
stock estimation results when making a request with the type parameter https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation set to type=stock estimation rainforest api will return information about the stock level of the given asin from the shopping cart an example of the json object returned from a stock estimation request is shown below { "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, "amazon url" "https //www amazon com/dp/b073jyc4xm" }, "request parameters" { "type" "stock estimation", "asin" "b073jyc4xm" }, "stock estimation" { "has stock estimation" true, "stock level" 27, "asin" "b073jyc4xm", "offer id" "abcdef12345", "min quantity" 1, "price" { "value" 39 99, "currency" "usd", "raw" "39 99" }, "is prime" true, "in stock" true, "message" "this seller has only 27 of these available to see if more are available from another seller, go to the product detail page ", "availability message" "usually dispatched within 2 to 3 weeks ", "seller" { "name" "sample seller", "id" "abcdef12345", "link" "https //www amazon com/gp/help/seller/at a glance html/ref=ox sc seller act 1?seller=abcdef12345" } } } 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 rainforest api returns the following properties for stock estimation requests property type description stock level number the stock level of the product as shown on the shopping cart page note that this value could be influenced by a number of factors such as a maximum purchase quantity allowed by the seller or availability of the product at the seller you should inspect the message property as this will show any alerts or messages shown on the shopping cart page also message string the message shown above the shopping cart this could contain information about the stock level for example, the message could indicate that the stock level shown is the maximum purchase quantity allowed by the seller, rather than the maximum number in stock availability message string the availability message shown above the shopping cart (i e ships in 2 3 weeks has stock estimation boolean set to false when rainforest cannot generate a stock estimation typically this property is set to false when the asin is shown as "currently unavailable" on the product detail page and therefore a stock estimation cannot be generated as the product cannot be added to the cart price object a price object showing price and currency information for the product min quantity number the minimum purchase quantity for the product, as shown on the shopping cart page in stock boolean whether the product is indicated as being in stock on the shopping cart page is prime boolean whether the product is indicated as being prime eligable as shown on the shopping cart page asin string the asin of the product as returned from the shopping cart page offer id string the offer id of the product offer as returned from the shopping cart page requires login boolean 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 when this is the case requires login will be set to true seller object the seller object contains details about the seller providing the offer for this stock estimation request only shown for third party marketplace sellers name string the name of the seller of the offer id string the id of the seller of the offer link string a link to the sellers shopfront on amazon (for third party sellers) next steps stock estimation parameters https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation