Core APIs
...
Product Data API
Parameters
Common
4min
common parameters get get /request the following parameters are used to configure your request to the product data api they should be appended as querystring parameters to a get http request to the /request endpoint for example, to request critical customer reviews, without a manufacturer reply, for the asin b073jyc4xm on amazon com the request would be http https //api rainforestapi com/request?api key=demo\&type=reviews\&amazon domain=amazon com\&asin=b073jyc4xm\&review stars=all criticalcurl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="reviews" \\ d amazon domain="amazon com" \\ d asin="b073jyc4xm" \\ d review stars="all critical"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "reviews", amazon domain "amazon com", asin "b073jyc4xm", review stars "all critical" } // make the http get request to rainforest api axios get('https //api rainforestapi com/request', { params }) then(response => { // print the json response from rainforest api console log(json stringify(response data, 0, 2)); }) catch(error => { // catch and print the error console log(error); })import requests import json \# set up the request parameters params = { 'api key' 'demo', 'type' 'reviews', 'amazon domain' 'amazon com', 'asin' 'b073jyc4xm', 'review stars' 'all critical' } \# make the http get request to rainforest api api result = requests get('https //api rainforestapi com/request', params) \# print the json response from rainforest api print(json dumps(api result json()))\<?php \# set up the request parameters $querystring = http build query(\[ 'api key' => 'demo', 'type' => 'reviews', 'amazon domain' => 'amazon com', 'asin' => 'b073jyc4xm', 'review stars' => 'all critical' ]); \# make the http get request to rainforest api $ch = curl init(sprintf('%s?%s', 'https //api rainforestapi com/request', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); $api result = curl exec($ch); curl close($ch); \# print the json response from rainforest api echo $api result; ?> request specific parameters additional parameters are available depending on the type of request being made (as determined by the type parameter) for example, if you make a request with type=offers then additional offers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/offers , specific to offers requests, are available common parameters the following common parameters are required for all requests to the product data api parameter required description api key required the api key for your rainforest api account type required the type of amazon data to retrieve the value of the type parameter determines which additional parameters are available for example, if you make a request with type=reviews then additional reviews parameters https //docs trajectdata com/rainforestapi/product data api/parameters/reviews , specific to reviews requests, are available valid values for type are product request data from the product page for an asin or amazon product page url see additional product parameters https //docs trajectdata com/rainforestapi/product data api/parameters/product stock estimation request stock estimation data for a given asin see additional stock estimation parameters https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation sales estimation request sales estimation data given asin or bestseller rank see additional sales estimation parameters https //docs trajectdata com/rainforestapi/product data api/parameters/sales estimation bestsellers request bestsellers data for a given bestsellers category see additional bestsellers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/bestsellers search request search results data for a given keywords on specific amazon sites see additional search parameters https //docs trajectdata com/rainforestapi/product data api/parameters/search offers request product offers for an asin or amazon product page url see additional offers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/offers reviews request customer reviews for an asin or amazon product page url see additional reviews parameters https //docs trajectdata com/rainforestapi/product data api/parameters/reviews review comments request customer review comments for a given review id see additional review comments parameters https //docs trajectdata com/rainforestapi/product data api/parameters/review comments reviewer profile request reviewer profile data for a reviewer id or amazon reviewer profile page url see additional reviewer profile parameters https //docs trajectdata com/rainforestapi/product data api/parameters/reviewer profile category request data for a given amazon category see additional category parameters https //docs trajectdata com/rainforestapi/product data api/parameters/category also bought request all of the products, including those behind the scroll, listed as "also bought with" in the also bought carousel on the product page see additional also bought parameters https //docs trajectdata com/rainforestapi/product data api/parameters/also bought seller profile request seller profile data for a seller id or amazon seller profile page url see additional seller profile parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller profile seller feedback request seller customer feedback results for a seller id see additional seller feedback parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller feedback seller products request product listings for products sold by an amazon seller specified by a seller id or amazon seller product listing page url see additional seller products parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller products questions request questions & answers for an asin or amazon product page url see additional questions parameters https //docs trajectdata com/rainforestapi/product data api/parameters/questions question answers request all answers (not just the default selected answer) for a question id or amazon question answers page url see additional question answers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/question answers autocomplete request all autocomplete suggestions see additional autocomplete parameters https //docs trajectdata com/rainforestapi/product data api/parameters/autocomplete author page request an author page for a given author asin or amazon authors page url see additional author page parameters https //docs trajectdata com/rainforestapi/product data api/parameters/author page store request an brand store for a given store id or amazon brand store page url see additional store parameters https //docs trajectdata com/rainforestapi/product data api/parameters/store charts request data from an amazon charts page for the given url see additional charts parameters https //docs trajectdata com/rainforestapi/product data api/parameters/charts asin to gtin request gtin / ean / upc / isbn values for a given asin on a given amazon domain see additional asin to gtin parameters https //docs trajectdata com/rainforestapi/product data api/parameters/asin to gtin can be used for converting asins to gtin / ean / upc / isbn numbers in bulk formats editions request data from the "formats & editions" popup typically shown on books product pages for a given asin on a given amazon domain see additional formats and editions parameters https //docs trajectdata com/rainforestapi/product data api/parameters/formats editions wishlist request data from amazon wishlists for a given wishlist id on a given amazon domain see additional wishlist parameters https //docs trajectdata com/rainforestapi/product data api/parameters/wishlist include html optional determines whether raw html is included in the response (this can increase the size of the response) can be set to true or false (the default) note when adding requests with include html=true to a collection the maximum number of requests is lower (100) because including the html within the response makes the collection result sets much larger the limit is in place to ensure result set files are of a manageable size if you have need to run a large number of requests all with include html=true then simply split the requests across multiple 100 request collections output optional determines the format in which results are returned can be set to json (default) to get the results as structured json, html to get the raw html retrieved or csv to return the results in csv format when using csv you can also use the csv fields parameter to specify which fields to return in the csv csv fields optional determines the fields that are returned when returning in csv mode (i e when the output parameter is set to csv ) should be specified as a comma seperated list of fields (in nested field, dot notation, format) for more information on the csv fields parameter please see the csv fields reference https //docs trajectdata com/rainforestapi/product data api/reference/csv fields customer location optional determines the location that rainforest uses when retrieving pages from amazon this is useful, for example, for seeing details of how a product appears on amazon com, to a customer located in a different country can be used to identify cross border shipping data and opportunities for more available values of customer location please see the customer locations reference https //docs trajectdata com/rainforestapi/product data api/reference/customer locations if no value for customer location is supplied then rainforest defaults to making the request from the country of the amazon page requested i e "france" for requests for pages from "amazon fr" customer zipcode optional determines the specific customer zipcode or postal code location of the request this is useful, for example, for seeing details highly localized listings such as amazon fresh to use the customer zipcode parameter you must first setup the zipcode, for the given amazon domain, in the zipcodes section https //app rainforestapi com/zipcodes of the dashboard for more information please see the customer zipcode reference https //docs trajectdata com/rainforestapi/zipcodes api/overview note the customer zipcode parameter cannot be used in conjuction with the customer location parameter language optional determines the display language rainforest requests the amazon page in for languages amazon support see supported languages https //docs trajectdata com/rainforestapi/product data api/reference/languages currency optional determines the currency rainforest requests the amazon page for supported currency values for each amazon domain see the supported currencies https //docs trajectdata com/rainforestapi/product data api/reference/currencies skip on incident optional instructs the api to not serve requests when a parsing incident is detected valid values are all (where the api will not serve a response if a "degraded" or "major" parsing incident is live) and major only (where the api will not serve a response is a "major" parsing incident is live, but will if a "degraded service" parsing incident is live) you can view service status via the status page https //rainforestapi statuspage io/ using skip on incident can be desirable if your system is making unsupervised requests to the api that you would like to gracefully fail in the event of an incident associate id optional pass your amazon associate id (your amazon affiliate id) and rainforest will append your associate id to all amazon links returned in all api responses (by appending the tag=yourassociateid parameter to all returned amazon links) include fields optional a comma seperated list json field names to include in the json object the api returns you can specify the field names in dot notation i e include fields=pagination will only include the the pagination property in the response json use include fields if you only want to include specific fields in the api's json response exclude fields optional a comma seperated list of json field names to exclude from the json object the api returns you can specify the field names in dot notation i e exclude fields=pagination will remove the pagination property from the response json use exclude fields if there are specific fields you wish to exclude from the api's json response next steps offers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/offers stock estimation parameters https //docs trajectdata com/rainforestapi/product data api/parameters/stock estimation reviews parameters https //docs trajectdata com/rainforestapi/product data api/parameters/reviews product parameters https //docs trajectdata com/rainforestapi/product data api/parameters/product search parameters https //docs trajectdata com/rainforestapi/product data api/parameters/search bestsellers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/bestsellers category parameters https //docs trajectdata com/rainforestapi/product data api/parameters/category also bought parameters https //docs trajectdata com/rainforestapi/product data api/parameters/also bought seller profile parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller profile seller feedback parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller feedback seller products parameters https //docs trajectdata com/rainforestapi/product data api/parameters/seller products autocomplete parameters https //docs trajectdata com/rainforestapi/product data api/parameters/autocomplete author page parameters https //docs trajectdata com/rainforestapi/product data api/parameters/author page