Core APIs
...
Parameters
Deals & Bestsellers
Deals
4min
deals parameters get get /request the deals parameters are applicable when making a request with type=deals to retrieve lightning deal / daily deals results from amazon's today's deals page the category of deals and amazon domain are specified using the category id and amazon domain parameter the parameters should be appended as querystring parameters to the product data api get http request deals results are retrieved from the deals listing page https //www amazon com/gp/goldbox on amazon category ids you can retrieve category ids for each amazon domain using the categories api https //docs trajectdata com/rainforestapi/categories api/overview category ids are also returned in the categories array in each type=deals response https //www rainforestapi com/docs/product data api/results/deals multiple category ids can be supplied, comma seperated, in the category id parameter for example, to request deals for beauty ( 3760911 ) and electronics ( 172282 ) categories on amazon com the parameters would be category id=3760911,172282\&amazon domain=amazon com if you wish to retrieve deals from the deals homepage for a given amazon domain , simply omit the category id parameter entirely for example, to request deals results for electronics category id of 172282 on amazon com the request would be http https //api rainforestapi com/request?api key=demo\&type=deals\&category id=15684181\&amazon domain=amazon comcurl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="deals" \\ d category id="15684181" \\ d amazon domain="amazon com"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "deals", category id "15684181", amazon domain "amazon com" } // 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' 'deals', 'category id' '15684181', 'amazon domain' 'amazon com' } \# 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' => 'deals', 'category id' => '15684181', 'amazon domain' => 'amazon com' ]); \# 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; ?> deals parameters the following parameters are available for all requests made when type=deals note that the common https //docs trajectdata com/rainforestapi/product data api/parameters/common include html=true , output=html , customer zipcode and customer location parameters cannot be used when making deals requests parameter required description category id optional a comma seperated list of deals category ids to retrieve deals results from, as returned by the categories api https //docs trajectdata com/rainforestapi/categories api/overview category ids are also returned in the categories array in each type=deals response https //docs trajectdata com/rainforestapi/product data api/results/deals multiple category ids can be supplied, comma seperated, in the category id parameter for example, to request deals for beauty ( 3760911 ) and electronics ( 172282 ) categories on amazon com the parameters would be category id=3760911,172282\&amazon domain=amazon com if you wish to retrieve deals from the deals homepage for a given amazon domain , simply omit the category id parameter entirely amazon domain optional the amazon domain to retrieve deals from for the category id(s) specified in the category id parameter for a full list of supported amazon domains see supported amazon domains https //docs trajectdata com/rainforestapi/product data api/reference/amazon domains deal types optional the types of deal to include if you omit the deal types parameter then all deal types are included note multiple deal types can be specified, comma separated valid values are lightning deal include lightning deals price range optional only includes deals for products within a specified price range if you omit the price range parameter then all deals are included note price tiers will vary based on amazon domain but for amazon com the current price tiers are 1 under $25 2 $25 to $50 3 $50 $100 4 $100 $1=200 5 $200 & above discount optional only include deals for products with with a discount range if you omit the discount discount parameter deals for products with any discount are included valid values are 10 percent off includes 10% off or more deals 25 percent off includes all 25% off or more deals 50 percent off includes all 50% off or more deals 70 percent off includes all 70% off or more deals prime early access optional determines whether to filter to only prime early access deals valid values are true filter to only prime early access deals prime exclusive optional determines whether to filter to only prime exclusive deals valid values are true filter to only prime exclusive deals minimum rating optional only include deals for products with a customer rating meeting the specified criteria if you omit the minimum rating parameter deals for products with any rating are included valid values are 1 and up include deals for products with a 1 star customer rating and upwards 2 and up include deals for products with a 2 star customer rating and upwards 3 and up include deals for products with a 3 star customer rating and upwards 4 and up include deals for products with a 4 star customer rating and upwards page optional the current page of deals results to retrieve inspect the pagination total pages property in the deals results https //docs trajectdata com/rainforestapi/product data api/results/deals to see how many pages of deal results are available max page optional use the max page parameter to get multiple pages of results in one request the api will automatically paginate through pages and concatenate the results into one response see the pagination https //docs trajectdata com/rainforestapi/product data api/pagination docs for more information next steps deals results https //docs trajectdata com/rainforestapi/product data api/results/deals