Category

category parameters get get /request the category parameters are applicable when making a request with type=category to retrieve category results for an amazon category categories can be specified either via passing an amazon category url in to the url parameter, or by passing a category id in to the category id (where the category id is returned from the categories api https //docs trajectdata com/rainforestapi/categories api/overview ) and an amazon domain in to the amazon domain parameter the parameters should be appended as querystring parameters to the product data api get http request category results are retrieved from the category listing page https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052 on amazon for example, to request category results for this category url https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052 , the request would be http https //api rainforestapi com/request?api key=demo\&type=category\&url=https%3a%2f%2fwww amazon com%2fs%3fbbn%3d16225009011%26rh%3dn%253a%252116225009011%252cn%253a502394%252cn%253a281052curl l get https //api rainforestapi com/request \\ d api key="demo" \\ d type="category" \\ d url="https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052"const axios = require('axios'); // set up the request parameters const params = { api key "demo", type "category", url "https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052" } // 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' 'category', 'url' 'https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052' } \# 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' => 'category', 'url' => 'https //www amazon com/s?bbn=16225009011\&rh=n%3a%2116225009011%2cn%3a502394%2cn%3a281052' ]); \# 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; ?> category parameters the following parameters are available for all requests made when type=category parameter required description category id optional a category id to retrieve results from you may supply any arbitary value in the category id parameter however we recommend using a category id returned from the categories api https //docs trajectdata com/rainforestapi/categories api/overview as these are known good category ids from amazon rainforest will use the category id in the following form https //amazon domain /s?node= category id note that pagination for top level categories is not supported by the amazon sites if you wish to iterate the contents of a category the recommended approach is to pick the lowest level categories to perform your iteration / pagination on amazon domain optional the amazon domain to retrieve category results from for a full list of supported amazon domains see supported amazon domains https //docs trajectdata com/rainforestapi/product data api/reference/amazon domains url optional the amazon category results page url to retrieve category results from be sure to url encode the url parameter note the url parameter is supplied, the category id parameter cannot be used (as the url itself defines the category id used) sort by optional determines the sort order of category results to return valid values are most recent sort category results by newest arrivals price low to high sort category results by lowest to highest price price high to low sort category results by highest to lowest price featured sort category results by featured first average review sort category results by average customer review page optional the current page of category results to retrieve inspect the pagination total pages property in the category results https //docs trajectdata com/rainforestapi/product data api/results/category to see how many pages of category 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 refinements optional a comma seperated list of refinement values to filter the category results by these allow you to refine your category results by values such as "reviews rating 4 and over", "price range" and "brand" refinement values are returned in the refinements array of each type=category result refinement values are dynamic and change by category area or search term used if you wish to use refinements you should first issue a type=category request without specifying any refinements to retrieve a master list of the avaialble refinements for the given category area/search term you can then cache these refinement values for use on subsequent requests for example, to run a type=search request specifying two refinements with values p 85/2470955011 and p 36/2421886011 the value of the refinements parameter would be refinements=p 85/2470955011,p 36/2421886011 note that sometimes amazon do not present a explicit refinement value and instead a link is returned in this instance you should pass the link into the url request parameter of your type=category request to retrieve data from that refinement filtered page next steps category results https //docs trajectdata com/rainforestapi/product data api/results/category