Reference
Product Updates
32 min
product updates we're continuously updating rainforest api to add features and functionality, most of which are a direct result of requests from customers see the latest updates below within the rainforest api dashboard https //app rainforestapi com/product updates you can subscribe to be alerted via email when new updates are released june 2025 update type view all book formats and editions with a single api call enhancement you can now retrieve all available formats and editions of a book—such as hardcover, paperback, kindle, audiobook, and special retailer editions—using the rainforest api this enhancement gives you a complete picture of how a book is being sold and priced across editions, making it easier to surface format level data, compare offers, and analyze product level detail at scale what's new when using the type=product endpoint for a book asin, you can now include "include all book formats" true this returns a new structured field in the response "book formats and editions" { } this includes total number of formats and editions ( formats and editions ) a count of unique formats ( formats ) structured objects for each format (e g , hardcover , kindle , audiobook , paperback , etc ) each format includes title asin image price (structured symbol, value, currency, raw) specifications (e g , publisher, edition, page count, dimensions, isbn 13) offer types (e g , new, used, collectible, when available) please note the number of credits consumed will scale based on the number of formats returned what this means for you this enhancement enables you to \ compare pricing and availability across book editions \ see exclusive editions from retailers like target, walmart, or b\&n \ build better product pages, variant selectors, or editorial content \ normalize book data for catalog intelligence or offer aggregation it’s especially useful for teams doing \ marketplace analysis \ book pricing & availability tracking \ variant level catalog building for questions or help getting started with this update, please reach out to your customer success manager or to our support team update type understand customer purchases and capture variant prices at scale enhancement we’ve released two enhancements to the rainforest api that help you extract more meaningful insights from product reviews and make it easier to access variant pricing in bulk 1 more contextful reviews with purchase metadata top reviews returned from type=product responses include additional purchase context—indicating which product variant (e g , color, size, or configuration) the customer bought this added metadata helps you link reviews to specific product variants improve confidence in review relevance enable more accurate product matching and analysis 2 csv support for variant prices requests you can now request variant prices using csv batch mode in the rainforest api to use it add a column to your batch csv file called variants flat set its value to true for any row where you want variant level pricing returned please note the value must be lowercase true this enhancement makes it easier to retrieve structured pricing data across multiple product variants in a single batch request—saving time and api overhead what this means for you these enhancements make it easier to connect reviews to specific customer purchases and scale your variant pricing retrieval workflows ideal for marketplace and product intelligence variant level pricing audits customer review analysis and ugc trust scoring retail analytics and product clustering for questions or help getting started with this update, please reach out to your customer success manager or to our support team https //trajectdata com/contact us/ may 2025 update type access new buy box details trade in, returns, protection plans, and one time prices enhancement we’ve expanded the buybox winner object to include several new data points—giving you deeper insight into what amazon presents at the point of purchase what's new the following fields are now parsed and returned when available on product detail pages trade in and save indicates whether a trade in discount is offered protection plans list of available protection plans, with plan name and duration price (value, currency, billing type) optional description and renewal policy return policy return window, policy type (e g , refund/replacement), and seller one time price price shown for one time purchases (e g , audible) how to use it these fields are returned within the buybox winner object on type=product responses no new parameters are required—if the data is present on the product page, it will be parsed automatically example response "buybox winner" { "trade in and save" true, "protection plans" \[ { "name" "3 year protection plan", "duration months" 36, "price" { "value" 28 99, "currency" "usd", "billing type" "one time" } } ], "return policy" { "duration days" 30, "type" "refund/replacement", "seller" "amazon com" }, "one time price" 323 } what this means for you these enhancements allow you to more accurately assess how products are being sold and presented in the buy box—including upsell offers, return flexibility, and purchase options whether you’re benchmarking, auditing pricing, or enriching product feeds, this gives you a more complete picture for questions or help getting started with this update, please reach out to your customer success manager or to our support team https //trajectdata com/contact us/ update type save more & stay covered with two new billing features enhancement we’ve launched two new features to help you save money and reduce billing related disruptions 1 switch to an annual plan & save up to 20% you can now upgrade to an annual plan and enjoy up to 20% in savings over monthly billing it’s the same api you rely on, just with more value and fewer invoices many customers are switching to annual to simplify billing and lock in long term savings how to switch to an annual plan 1 log in to your account 2 navigate to account in the left hand navigation 3 go to plan & payment 4 click choose a plan , then select your preferred annual plan log in to your account to get started and switch to an annual plan today! 2 add a backup credit card to acvoid disruptions you can now add a secondary credit card to your account if your primary card fails (due to expiration, fraud blocks, or insufficient funds), we’ll automatically attempt to charge your backup — helping you avoid account suspension and api service interruptions how to add a backup card 1 log in to your account 2 navigate to account in the left hand navigation 3 go to plan & payment 4 click manage payment method 5 click add a new card and enter your backup credit card details 6 you can set it as default at any time with the set as default option log in to your account to manage your payment methods for questions or help getting started with this update, please reach out to your customer success manager or to our support team https //trajectdata com/contact us/ april 2025 update type detail new feature new feature unlock more global and granular detail from amazon results we’ve shipped three improvements to the rainforest api that expand what you can extract from amazon pages these updates improve support for category accuracy, international shipment visibility, and result set parsing—giving you a deeper and more flexible understanding of marketplace data 1 amazon best seller & audible categories updated get accurate best seller category ids across amazon domains get accurate best seller category ids across amazon domains what's new we’ve updated the best seller category ids across all supported amazon domains and expanded audible/audiobook categories for several international marketplaces what’s covered best seller categories updated for all domains audible/audiobook categories updates for spain, france, italy, canada, and australia what this means for you you’ll now receive more accurate and complete category data—especially useful when analyzing rank, browsing metadata, or building category specific filters internationally 2 detect international shipment by third party (3p) sellers know when amazon ships an item internationally know when amazon ships an item internationally what's new the fulfillment object now includes a new boolean field— is fulfilled by amazon international —that tells you whether amazon is fulfilling the item from an international location how it works applies to type=product responses the flag is true when amazon ships the item across borders (e g , from a german fc to an austrian buyer) this flag appears inside the fulfillment object alongside existing delivery metadata works regardless of whether the item is 1p or 3p, as long as amazon is the fulfiller example response "fulfillment" { "is fulfilled by amazon international" true } what this means for you this helps you distinguish local amazon fulfillment from international shipping—essential for delivery time analysis, customs considerations, and understanding where inventory is sourced 3 amazon search result count parsing see how many results were returned for a given keyword what’s new we now parse the total number of search results returned for keyword searches using type=search this information is returned in a new search information object example response "search information" { "results text raw" "49 96 of over 100,000 results for \\"chocolate\\"", "results begin" 49, "results end" 96, "total results" 100000, "search term" "chocolate" } what this means for you whether you’re tracking keyword competitiveness, reporting on category saturation, or tuning search strategies, this new field gives you a clearer view of what’s being returned—and how much update type detail new feature new feature access faster, lighter responses with new selective parsing and combined search & product scrapes we’ve released two enhancements to the rainforest api that improve the speed, precision, and efficiency of your amazon workflows with selective parsing , you can trim down responses to only the fields you need and with combined search + product scrapes , you can retrieve more data in fewer calls—making your requests simpler and faster 1 streamline amazon api responses with selective parsing we’ve added a new fields parameter to the rainforest api, allowing you to return only the data you actually need from search and product endpoints this gives you greater control over your payloads while improving speed and efficiency—especially at scale what's new you can now use the fields parameter to retrieve only the data points you care about in both type=search and type=product rainforest api calls this results in smaller payloads and faster response times how to use it add fields= to your api request with a comma separated list of top level or nested field names (dot notation supported) example request https //api rainforestapi com/request?api key=\<api key>\&type=search\&amazon domain=amazon com\&search term=paranormal+detective\&number of results=10\&fields=search results price,search results product bestsellers rank please note this feature is not currently supported for batch requests what this means for you you get precise control over which data points are returned, helping reduce bandwidth costs, eliminate unnecessary parsing, and streamline your workflows 2 simplify amazon scraping with combined search + product calls this update introduces a smarter way to scrape amazon a single type=search request can now trigger product requests for the top search results—delivering all the data in one combined response no more chaining multiple calls or stitching together datasets what’s new you can now make a single type=search request that automatically triggers type=product requests for the top search result—all returned in one combined response how to use it add include products count= to your type=search call to specify how many top results should return full product details you can optionally use fields= to limit the response to only key data points example request https //api rainforestapi com/request?api key=\<api key>\&type=search\&amazon domain=amazon com\&search term=paranormal+detective\&number of results=10\&include products count=5\&fields=search results price,search results product specifications please note this feature is not available via batch requests, and each type=product requests triggered will count as a separate api request what this means for you you can streamline your scraping flow and reduce the number of api calls instead of chaining requests manually, you’ll get both search and product data faster—in a single, easy to parse response for questions or help getting started with amazon data collection via our rainforest api, please reach out to our support team https //trajectdata com/contact us/ or your customer success manager march 2025 true false 159false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type february 2025 true false 159false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type december 2024 true false 157false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type september 2024 true false 157false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type july 2024 true false 157false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type may 2024 true false 161false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type march 2024 true false 141false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type july 2023 true false 159false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type june 2023 true false 150false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type april 2023 true false 157false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type feburary 2023 true false 154false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type january 2023 true false 155false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type november 2022 true false 149false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type july 2022 true false 145false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type june 2022 true false 148false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type may 2022 true false 153false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type april 2022 true false 146false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type march 2022 true false 149false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type feburary 2022 true false 134false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type january 2022 true false 139false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type december 2021 true false 136false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type november 2021 true false 138false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type october 2021 true false 129false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type september 2021 true false 158false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type august 2021 true false 149false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type july 2021 true false 141false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type true falsefalse left unhandled content type