Core APIs
Product Data API

Getting Started

8min

Getting Started

Rainforest API is an API to retrieve data from any Amazon domain worldwide in real-time. You can use Rainforest API to retrieve products, reviews, review comments, offers, lightning deals, category results, search results, also-bought products, seller profiles, seller feedback, seller products, reviewer profile, questions, extended question answers and bestselling products from any Amazon site.



We recommend watching this short video introduction to the Rainforest API web app.



Rainforest API executes requests in real time and returns clean, structured JSON or CSV results. You can achieve fine-grained control over your request using the request parameters.

Lookup an ASIN by GTIN / ISBN / UPC / EAN Rainforest API can automatically convert GTIN/ISBN/UPC/EAN codes to ASINs and return product data. For details of how to lookup Amazon product details by GTIN/ISBN/UPC/EAN please see refer to the guide.

Note that Rainforest will cache the GTIN-to-ASIN mapping for 2 months. To force a new GTIN lookup (for example, if you suspect the existing mapping is stale), use the skip_gtin_cache=true request parameter (note that using skip_gtin_cache=true decrements 2 credits from your balance, instead of 1).

Customer Zip & Postal Codes Rainforest API allows you to set up zip or postal codes and run your requests in the context of those zipcodes. This is useful for retrieving data from highly localized ASINs such as Amazon Fresh.

View the Customer Zipcodes docs to learn more about setting up customer zipcodes on your account and using them in your requests.



Retrieving Bestselling Products on Amazon

GET /request

Getting Amazon data with Rainsforest API is as simple as making an HTTP GET request to the request endpoint. The only required parameters are api_key (sign up for free to get an API key) and type (which defines the type of Amazon data you'd like to retrieve).

For example, to retrieve Bestselling products ( type=bestsellers ) for the "memory cards" Amazon Bestsellers page on amazon.com https://www.amazon.com/s/zgbs/pc/516866 the Rainforest API request would be:

HTTP
Curl
Node.js
Python
PHP


To view Rainforest API JSON results clearly in your browser we recommend these extensions for Chrome and Firefox

The results of the Bestsellers request are shown below, the bestselling products are within the bestsellers array. For full documentation on Bestsellers results see the Bestsellers Results docs.

JSON


Response Times & Concurrency Rainforest API gathers data from Amazon in real-time and will typically return a result in 1-6 seconds. Please inspect the HTTP Response Code and update your app accordingly.

If you need to run large volumes of requests consider using the Collections API. Collections allow you to enqueue up to 15,000 requests, run them manually or on a schedule and execute them concurrently on Rainforest API's infrastructure.



Getting Data for an Individual Product

GET /request

Lets say we want to change our query to request a different type of data - information on a specific product, in this case the ASIN (Amazon product identifier) B000YDDF6O on amazon.com . Here's the Rainforest API request to achieve that:

HTTP
Curl
Node.js
Python
PHP


The result of the Product request is shown below. For full documentation on Product results see the Product Results docs.

JSON


Updated 11 Oct 2024
Did this page help you?