Reference

Product Updates

24min

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 you can subscribe to be alerted via email when new updates are released.

September 2024

Update Type

Detail

New Feature

Track a product's sales velocity! Recent Sales are now returned with Rainforest product results

Rainforest API's product results now include recent_sales indicating how many sales occurred in the past month (or other stated time period.)

  • 

    Document image
    



July 2024

Update Type

Detail



[Reminder] Prime Day: Rainforest product results capture Prime Exclusive deals

Rainforest API can now return results with is_prime_exclusive_deal when request type=product to indicate whether a product is a Prime Exclusive Deal.

Read More

  • 

    Document image
    

Enhancement

Update to Amazon Choice in search results

We updated the parser to populate the amazon_choice object in results for products with the “Overall Pick” badge.

Amazon changed the badge name from “Amazon Choice” to “Overall Pick” so the amazon_choice object was returning an empty result.

Note : Amazon only changed the badge name in the search results. The Amazon Choice badge still appears on the product page.

Read More

  • 

    Document image
    

New Feature

Find the Best Reads! Four new gift guide badges for top books are now in product results!

Rainforest API's gift_guide_badge object now includes the Teachers’ Pick, the Children’s Book Tip, the Editors' Pick, and the Goodreads Choice badges in Product results when available on the Amazon product page for any book format (Kindle, Audiobook, Hardcover, Paperback).

If the badge is shown on the product page, the property is set to True .

Read More

  • 

    Document image
    

May 2024

Update Type

Detail

New Feature

Read sample added to product results!

Rainforest API now includes a read_sample object in Product results when a book is requested. The JSON object looks like this (example):

read_sample:{

read_sample_exists : true

read_sample_asin :'B01E0DMGOK'

}

where read_sample_exists indicates if a sample is available on Amazon’s product page. If it is available, then the read_sample_asin and read_sample_link are also provided.

Read More

  • 

    Document image
    

Enhancement

Changes to the summarization_attributes in Product results

Due to changes in the Amazon source data, we have updated the the Product results shown when include_summarization_attributes=true is set in the request.

Previously, Amazon summarized reviews in the “Read reviews that mention” section. They have replaced that section with the AI-generated “Customers say” section.

Therefore, we updated our properties as follows to reflect the changes:

summarization_attributes : removed the ID from the array. (Amazon no longer includes this ID in their results.)

customers_say : replaced the reviews_that_mention property with the customers_say property.

The customers_say property array includes:

name : the attribute summarized from the reviews

value : the value of the attribute (Positive, Mixed, Negative) For more details, read more on Product Parameters and Product Results in our documentation.

Read More

  • 

    Document image
    

Enhancement

Audio Sample available in Rainforest Product results for all book formats

Rainforest results will now include the link to the audible_sample , if one is available, for all book formats (Hardcover, Paperback, Audiobook or Kindle). Previously, the results only included the Audible sample link for the audiobook format.

Read More

  • 

    Document image
    

March 2024

Update Type

Detail

New Feature

Amazon Big Spring Sale items identified in search results

Rainforest API now returns two additional properties in the buybox winner object to identify products included in the Amazon Big Spring sale. For type=search , results include is_big_spring_deal (boolean) and big_spring_deal_percentage (number). Read More

  • 

    Document image
    

July 2023

Update Type

Detail



Meet Our Newest API! 🎉

We’ve just launched Backyard API , our real-time Lowe’s product data API and companion to BigBox API for home improvement data . Let us know what you think of our newest addition or if you need any help. As always, you can try it out free!

Enhancement

Prime Day 2023: Rainforest deals results capture Prime Day and Prime Exclusive deals

Rainforest API can now return results that extract is_prime_day_deal and is_prime_exclusive when request type=deals to indicate whether a product is a Prime Day or Prime Exclusive deal.

Read More

Enhancement

Prime Day 2023: Rainforest product results now capture Prime Exclusive deals

Rainforest API can now return results with i s_prime_exclusive_deal when request type=product to indicate whether a product is a Prime Exclusive Deal.

Read More

  • 

    Document image
    

June 2023

Update Type

Detail

Enhancement

Coverage of new author_page landing pages

Rainforest can now return results for the request type=author_page for the new author page (landing page) layout on the amazon.es , amazon.fr , and amazon.de domains.

Read More

  • 

    Document image
    

Enhancement

Approximate recent sales velocity and recent views are now returned in searches results

Rainforest API can now return recent_sales and recent_views when type= search. Where shown, a product’s approximate recent sales and recent number of views will be returned in search results.

For example: 200+ bought in past week and 300+ viewed in past week

Read More

April 2023

Update Type

Detail



Business UpdateAs a result of significant growth, our infrastructure — namely the dynamic routing of traffic to accommodate high volume customers — has recently required updates. Reworking architecture patterns and proxy configurations has taken us a fair amount of time, which in turn has led to some slower customer issue resolution.

We'd like to assure you that we’ve identified and corrected the infrastructural shortcomings, and the outcome is a 50% increase in infrastructure and proxy capacity. We apologize for the potential business interruptions you may have experienced over the last couple months. Our aim is to earn your trust back and continue to support the realization of your business goals. Please don’t hesitate to get in touch if you require further information.

Feburary 2023

Update Type

Detail

New Feature

Help us choose our next API!

What should we build next?

Our product team values your feedback. If you'd like to, let us know your thoughts on which APIs to include on our roadmap. 

Survey

January 2023

Update Type

Detail

Enhancement

Amazon Discount for Buy Box Winner

Rainforest can now return amazon_discount - the discount provided by Amazon when a product is sold by a third-party seller.



In this scenario, Amazon does not display the rrp , however, it will be calculated by the price + amazon_discount .

Read More

  • 

    Document image
    

November 2022

Update Type

Detail

New Feature

Maximum and Minimum Order Quantity added to Offers Results

The minimum and maximum order quantity object has been added to the Offers array.

Read More

  • 

    Document image
    

New Feature

Additional Details now returned in Product Results

Rainforest can now return the additional_details property, containing an array of details about the seller (i.e. Small Business and Black Owned Business badge), in the results of a product search. Read More

  • 

    Document image
    

July 2022

Update Type

Detail

New Feature

New "Wishlist" result type added

Rainforest can now return data from Amazon Wishlist pages with the newly launched type=wishlist request.

Read More

  • 

    Document image
    

Enhancement

Size Guide returned for clothing Product page requests

New properties have been added to the type=product response to return data from the Size Guide popup for fashion/clothing products that have a Size Guide shown on the product page.

has_size_guide will be set to true when the size guide is shown, and size_guide_html will contain the HTML of the size guide popup

Read More

  • 

    Document image
    

Enhancement

Minimum order quantity returned for Product requests

The minimum order quantity, if shown in the product page Buybox, is now returned in type=product requests. Both the value (a number) and the accompanying message text are returned.

Read More

  • 

    Document image
    

Enhancement

Luxury Stores data returned in Product requests

Parsing of Amazon "Luxury Stores" detail pages has been added to Rainforest's "type=product" response.

Read More

  • 

    Document image
    

Enhancement

Critic Reviews added for Audible

Critic Reviews are now returned in a type=product responses' editorial_reviews array.

Read More

  • 

    Document image
    

New Feature

Support for Amazon China (amazon.cn) added

Support has been added for the Amazon China domain ( amazon.cn ).

You can use amazon_domain=amazon.cn to request product page, search results, reviews and category listings for Amazon.cn.

Read More

  • 

    Document image
    

June 2022

Update Type

Detail

Enhancement

Support for product requests using "a.co" short-links

Support has been added for specifying type=product requests using the "https://a.co/xxx" short-domain (that redirects to an Amazon product page).

Read More

Enhancement

Secondary Buybox pricing added to Product response

A new property of secondary_buybox has been added to the buybox_winner object, populated when a secondary buybox offer is presented by Amazon on the product page.

Read More

  • 

    Document image
    

New Feature

Support for custom S3-compatible object stores in Destinations

It's now possible to specify a custom S3 endpoint to have Destinations upload Result Sets to any S3 compatible object store.

Read More

  • 

    Document image
    

Enhancement

Image overlay badges returned in Product response

The image overlay badge property contains details of the overlay badge, if shown and not forming part of the original image bitmap. The image overlay badge object has the following properties:

Read More

  • 

    Document image
    

May 2022

Update Type

Detail

Enhancement

Support added for requesting Amazon results in different currencies

A new currency parameter has been added to allow requesting of results in different currencies.

The available currencies depend on the Amazon domain requested.

Read More

  • 

    Document image
    

Enhancement

New properties on Search Results

3 new properties have been added to type=search responses that are set to true when the respective badges are shown next to Amazon search results - is_amazon_brand , is_exclusive_to_amazon , is_small_business .

Read More

  • 

    Document image
    

Enhancement

Image links extracted from A+ content

A new all_images array has been added to the a_plus_content property populated with all of the images from the A+ content section on type=product requests with the include_a_plus_body=true parameter set.

Read More

April 2022

Update Type

Detail

New Feature

New request type - Formats and Editions - launched

A new request type - Formats and Editions has been launched.

Formats and Editions ( type=formats_editions ) allows you to retrieve data from the Formats & Editions popup (typically shown on books and collectables product pages to list all of the ASINs of different formats of the current ASIN).

Read More

  • 

    Document image
    

Enhancement

Vine Program Free Product flag added

Rainforest type=reviews responses now include a vine_program_free_product boolean, set to true when the "Vine Customer Review of Free Product" badge is shown next to the review.

Read More

  • 

    Document image
    

March 2022

Update Type

Detail

Enhancement

Promotion details added to Offers response

A new promotions structure has been added to type=offers results to show any promotions related to the seller offer.

Read More

  • 

    Document image
    

Feburary 2022

Update Type

Detail

New Feature

Climate Pledge Friendly info returned from Search requests

Rainforest will now return a new climate_pledge_friendly structure from type=search requests whenever the Climate Pledge Friendly certification badge is shown next to search results. The text of the certification, product page link and image are returned.

Read More

  • 

    Document image
    

January 2022

Update Type

Detail

New Feature

Ability to retrieve Top 100 Free bestsellers lists

A new is_free=true request parameter has been added to type=bestsellers requests. This allows the retrieval of the Top 100 Free bestsellers lists, in addition to the existing Top 100 Paid bestsellers lists. Read More

  • 

    Document image
    

Enhancement

Avatar image URL returned in Reviews requests

A new property has been added to type=reviews requests to return the reviewer avatar image URL under the profile.image property.

Read More

December 2021

Update Type

Detail

Enhancement

Search refinements added to Seller Products requests

The refinements property has been added to type=seller_products responses and is also available type=seller_products responses.

Refinements allow you to narrow your request down to just Seller Products results of a given brand, price range, etc.

Read More

  • 

    Document image
    

Enhancement

Holiday delivery message added to Product response

Holiday delivery message added to the type=product response under the fulfilment object.

Read More

  • 

    Document image
    

Enhancement

"Similar item to consider" added to Product response

A new similar_to_consider property has been added to the type=product response to return the "value pick" / "similar item to consider" ASIN from the product detail page, if shown.

Read More

  • 

    Document image
    

Enhancement

Top Reviews now available for Product requests

A new top_reviews array property is available on type=product requests showing the top reviews as-displayed on the product detail page.

Full reviews for a given ASIN are always available via the existing type=reviews request.

Read More

  • 

    Document image
    

November 2021

Update Type

Detail

Enhancement

Kindle Unlimited flag returned for search requests

A new kindle_unlimited property has been added to the search results endpoint. The property will be set to true when the search result is shown as a Kindle Unlimited product.

Read More

  • 

    Document image
    

Enhancement

Israel added as a customer location for Amazon.com

Israel has been added as a customer_location for Amazon.com requests allowing you to request cross-border shipping data from Amazon.com to Israel.

Read More

  • 

    Document image
    

Enhancement

Select all CSV Fields

We have added Select All / Select None options to quickly select all CSV fields in the Collection editor and API Playground to make choosing CSV fields much quicker.

Read More

October 2021

Update Type

Detail

New Feature

Sponsored "Related Brands" from search results returned

Rainforest will now return the Related Brands section showing the sponsored related brands, typically found at the bottom of the search results page.

Related Brands are parsed out in the new related_brands array in type=search responses.

Read More

  • 

    Document image
    

New Feature

"Video Blocks" returned in Search responses

Rainforest now returns an array of "video block" objects detailing the full-row sponsored video sections shown on the search results page (if shown).

Typically video blocks contain a video, along with a link to one or more products related to the video.

Read More

  • 

    Document image
    

Enhancement

Search result Carousels returned in Search responses

Rainforest now returns a new property carousel in type=search responses. The carousel property contains details of the carousel that the search result is part of. Examples of carousels can include sponsored products, "Highly Rated" or "Today's Deals".

They differ from the existing ad_blocks responses in that they are horizontally scrollable and nested inline with the natural, organic, search results.

Read More

  • 

    Document image
    

Enhancement

EU Energy Efficiency labels and rating in Product responses

EU Energy Efficient ratings, where shown on the product detail page, are now return in Rainforest type=product responses.

Read More

  • 

    Document image
    

New Feature

Sales Estimation endpoint released

Rainforest now supports generating monthly sales estimations for a specific asin and amazon_domain , or for any arbitrary bestseller_rank and sales_estimation_category .

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 a estimated weekly and monthly sales volumes.

Read More

  • 

    Document image
    

September 2021

Update Type

Detail

Enhancement

"Did you mean" search spelling auto-corrections

A new object has been added to the type=search response to show the "did you mean" search term spelling correction text.

Note that you can control whether the spelling-corrected test is automatically followed using the direct_search=true request parameter.

Read More

  • 

    Document image
    

New Feature

Rich Product Descriptions added to Product page response

An array containing the "rich product description" sections typically found on premium beauty product pages has been added to Rainforests' type=product (product page) response.

The Rich Product Description section is typically found on premium beauty product pages.

Read More

  • 

    Document image
    

New Feature

Support for Amazon Egypt (amazon.eg) added

Support for Amazon Egypt (amazon.eg) has been added to Rainforest. Run your requests with amazon_domain=amazon.eg to request data from Amazon Egypt.

Read More

  • 

    Document image
    

Enhancement

Search Alias returned in Product results

A new property search_alias has been added to the type=product API response. The Search Alias property shows the title and value of the search alias shown at the top of the product page.

Read More

  • 

    Document image
    

Enhancement

Filter Collections by Last Run date

The Collections List API has been updated to allow sorting Collections by last_run date. You can also now filter the Collections by date using the last_run_before and last_run_after request parameters.

The Collections Dashboard has also been updated to show the Last Run date for each Collection.

Read More

  • 

    Document image
    

August 2021

Update Type

Detail

Enhancement

Per-minute Collection scheduling improvements

The Per X Minutes Collection scheduling options have been extended to allow you to run Collections on a "Per X Minute" schedule restricted to specific hours of the day and days of the week or month.The schedule_hours , schedule_days_of_week and schedule_days_of_month can now be used with schedule_type=minutes Collections for additional flexibility.

This allows for scenarios such as "run this Collection every 5 minutes, between 9am and 5pm, on weekdays only".

Read More

  • 

    Document image
    

New Feature

Run Collections on a per-minute schedule

Collections can now be scheduled on a per-minute basis, in addition to the existing hourly, daily, weekly and monthly schedules.

Set schedule_type=minutes when creating your Collection and specify the per-minute schedule using the schedule_minutes parameter.

Per-minute schedules of every minute up to every hour are supported.

Read More

  • 

    Document image
    

New Feature

Account Balance added to Account API

The Account API has been updated to include your current Account Balance in the account_balance_usd property. Your Account Balance is used to settle any Overage charges (to avoid multiple small overage charges being made to your payment card). You can top up your Account Balance at any time on the Account page of the Dashboard.

Read More

New Feature

Japan added as a "customer_location" for Amazon.com requests

Japan has been added as a customer location for use with Amazon.com requests. This allows for cross-border shipping data to be returned for shoppers located in Japan, ordering from Amazon US.

Read More

  • 

    Document image
    

Enhancement

Business name and address returned from Seller Profile requests

Business name (distinct from the Seller "brand" name) and business address have been added to the type=seller_profile response under the new business_name and business_address properties.

Read More

  • 

    Document image
    

New Feature

France added as a "customer_location" for Amazon.de requests

France has been added as a customer location for use with Amazon.de requests. This allows for cross-border shipping data to be returned for shoppers located in France, ordering from Amazon Germany.

Read More

  • 

    Document image
    

Enhancement

"From the brand" Brand Story section now parsed in Product requests

Rainforest will now extract the hero image, logo image, brand description, FAQ's and promoted products from the "Brand Story" section of the A-Plus content on type=product requests. This new parsing will be populated into the a_plus_content.brand_story object.

Read More

  • 

    Document image
    

Enhancement

Store Info with logos etc included on Brand Store requests 

We have updated the Brand Store response to include a new store_info structure that includes the Brand Store logo image, description and hero image.

Read More

  • 

    Document image
    

New Feature

Reviews extraction added for Audible domains

Audible domains are now supported for type=reviews requests.When specifying an Audible domain in a type=reviews request - i.e. amazon_domain=audible.com , the reviews are retrieved from the Amazon Reviews for the given ASIN, rather than the Audible Reviews.

Read More

  • 

    Document image
    

New Feature

Subscribe and Save data added to Product response

Subscribe and Save parsing has been added to the API's type=product response. This includes the base and tiered subscribe and save pricing, plus the associated discount percentages along with the delivery message.

Read More

  • 

    Document image
    

New Feature

"Compare with similar items" data added to Product response

The "Compare with similar items" section of the product page has been added to Rainforest's response to type=product requests.

Read More

  • 

    Document image
    

Enhancement

Downloadable documents extracted for Product requests

Downloadable documents (i.e. User Guide PDF's, specification documents etc) are now extracted in type=product responses, where they are shown on the Product Page itself.

The downloadable documents can be found in the new documents array.

Read More

  • 

    Document image
    

Enhancement

English (United Kingdom) language available 

English (United Kingdom - en_GB ) is now available as a supported language when making API requests.

Read More

New Feature

New Collections API endpoint to Stop All queued and running Collections

The new Stop All Collections API endpoint allows you to stop all running and queued Collections on your account in one API call. Useful if you have accidentally started a large number of Collections and need a quick way to set them all back to idle .

Read More

Enhancement

Extract "rating" when product is no longer available for purchase

The rating field will now be extracted, if shown, when the selected ASIN is no longer available for purchase in type=product requests.

Enhancement

A-Plus body content available stripped of HTML tags

A new field a_plus_content.body_text is now available in addition to the existing a_plus_content.body property. The new property contains the A-Plus descriptive content but stripped of any HTML tags.

July 2021

Update Type

Detail

New Feature

Editorial content extracted on Store results

Rainforest will now extract editorial content for type=store requests . Store result pages can have different layouts and are not always a standard list of ASIN result.

If a store_result has the type=editorial then the ASIN is being displayed as a graphic/creative, instead of a regular ASIN product listing. Previously it was not possible to extract the ASIN detail behind these creative images.

Read More

  • 

    Document image
    

New Feature

Audible product page parsing

Introduced Audible parsing for type=product (product page) requests. Read More

Enhancement

Exclude sponsored results from search requests

Added a new request parameter exclude_sponsored to type=search requests to instruct the API not to returned sponsored search results.

Enhancement

Audible sample MP3 links

Audible sample MP3 links are now returned in the product.audible_sample property for ASINs that contain an Audible sample.

  • 

    Document image
    

We started publishing Product Updates in June 2021, please refer to update emails for updates before this date.



Updated 24 Sep 2024
Did this page help you?