Core APIs
...
Results
Deals & Bestsellers

Bestsellers

2min
bestsellers results when making a request with the type parameter https //docs trajectdata com/rainforestapi/product data api/parameters/bestsellers set to type=bestsellers rainforest api will return bestseller results from an amazon bestsellers page the bestsellers page is specified either using the category id and amazon domain parameters (where category id is a category id returned from the categories api https //docs trajectdata com/rainforestapi/categories api/overview , or by using the url parameter rainforest supports all types of amazon bestseller pages, bestsellers https //www amazon com/best sellers appliances/zgbs/appliances/ref=zg bs nav 0 , new releases https //www amazon com/gp/new releases/appliances/ref=zg bsnr nav 0 , movers & shakers https //www amazon com/gp/movers and shakers/appliances/ref=zg bsms nav 0 , most wished for https //www amazon com/gp/most wished for/appliances/ref=zg mw nav 0 and gift ideas https //www amazon com/gp/most gifted/appliances/ref=zg mg nav 0 an example of the json object returned from a bestsellers request is shown below { "request info" { "success" true, "credits used" 1, "credits remaining" 999 }, "request metadata" { "id" "763fc1a4b3eb053f5c8f20f12655b09dfd36130d", "created at" "2020 01 01t00 00 00 000z", "processed at" "2020 01 01t00 00 00 001z", "total time taken" 0 1, "amazon url" "https //www amazon com/best sellers computers accessories memory cards/zgbs/pc/516866" }, "request parameters" { "type" "bestsellers", "url" "https //www amazon com/best sellers computers accessories memory cards/zgbs/pc/516866" }, "bestsellers" \[ { "rank" 1, "position" 1, "title" "samsung 128gb 100mb/s (u3) microsdxc evo select memory card with full size adapter (mb me128ga/am)", "sub title" { "text" "akaso", "link" "https //www amazon com/akaso/b/ref=bl dp s web 7188749011?ie=utf8\&node=7188749011\&field lbr brands browse bin=akaso" }, "asin" "b073jyc4xm", "link" "https //www amazon com/samsung microsdxc adapter mb me128ga am/dp/b073jyc4xm/ref=zg bs 516866 1/133 5420936 7189629? encoding=utf8\&psc=1\&refrid=8v9x0q7p2drn4tw5tdnb", "image" "https //images na ssl images amazon com/images/i/817wkpgultl ac ul200 sr200,200 jpg", "rating" 4 7, "ratings total" 44828, "price" { "symbol" "$", "value" 19 49, "currency" "usd", "raw" "$19 49" } }, { "rank" 2, "position" 2, "title" "sandisk ultra 32gb microsdhc uhs i card with adapter 98mb/s u1 a1 sdsquar 032g gn6ma", "sub title" { "text" "akaso", "link" "https //www amazon com/akaso/b/ref=bl dp s web 7188749011?ie=utf8\&node=7188749011\&field lbr brands browse bin=akaso" }, "asin" "b073jwxgnt", "link" "https //www amazon com/sandisk ultra microsdxc memory adapter/dp/b073jwxgnt/ref=zg bs 516866 2/133 5420936 7189629? encoding=utf8\&psc=1\&refrid=8v9x0q7p2drn4tw5tdnb", "image" "https //images na ssl images amazon com/images/i/61wtfkbzuil ac ul200 sr200,200 jpg", "rating" 4 6, "ratings total" 42742, "price" { "symbol" "$", "value" 8 14, "currency" "usd", "raw" "$8 14" } }, { "rank" 3, "position" 3, "title" "sandisk ultra 32gb class 10 sdhc uhs i memory card up to 80mb/s (sdsdunc 032g gn6in)", "sub title" { "text" "akaso", "link" "https //www amazon com/akaso/b/ref=bl dp s web 7188749011?ie=utf8\&node=7188749011\&field lbr brands browse bin=akaso" }, "asin" "b0143rt8oy", "link" "https //www amazon com/sandisk ultra class memory sdsdunc 032g gn6in/dp/b0143rt8oy/ref=zg bs 516866 3/133 5420936 7189629? encoding=utf8\&psc=1\&refrid=8v9x0q7p2drn4tw5tdnb", "image" "https //images na ssl images amazon com/images/i/61rlnh5af2l ac ul200 sr200,200 jpg", "rating" 4 6, "ratings total" 18440, "price" { "symbol" "$", "value" 6 99, "currency" "usd", "raw" "$6 99" } }, { "rank" 4, "position" 4, "title" "sandisk 64gb ultra microsdxc uhs i memory card with adapter 100mb/s, c10, u1, full hd, a1, micro sd card sdsquar 064g gn6ma", "sub title" { "text" "akaso", "link" "https //www amazon com/akaso/b/ref=bl dp s web 7188749011?ie=utf8\&node=7188749011\&field lbr brands browse bin=akaso" }, "asin" "b073jyvknx", "link" "https //www amazon com/sandisk ultra microsdxc memory adapter/dp/b073jyvknx/ref=zg bs 516866 4/133 5420936 7189629? encoding=utf8\&psc=1\&refrid=8v9x0q7p2drn4tw5tdnb", "image" "https //images na ssl images amazon com/images/i/51ievgce89l ac ul200 sr200,200 jpg", "rating" 4 6, "ratings total" 42742, "price" { "symbol" "$", "value" 11 99, "currency" "usd", "raw" "$11 99" } } ], "pagination" { "current page" 1, "total pages" 2 }, "bestsellers info" { "current category" { "name" "bebé", "link" "https //www amazon es/gp/bestsellers/apparel/1895733031", "id" "1895733031" }, "parent category" { "name" "ropa", "link" "https //www amazon es/gp/bestsellers/apparel/ref=zg bs unv a 1 1895733031 1", "id" "apparel" }, "child categories" \[ { "name" "niñas de hasta 24 meses", "link" "https //www amazon es/gp/bestsellers/apparel/1909379031/ref=zg bs nav a 2 1895733031", "id" "1909379031" }, { "name" "niños de hasta 24 meses", "link" "https //www amazon es/gp/bestsellers/apparel/1909318031/ref=zg bs nav a 2 1895733031", "id" "1909318031" } ] } } rainforest api returns the following properties for bestsellers requests property type description bestsellers array an array of bestseller result objects, containing each of the product results shown on the bestsellers page the bestseller result object has the following properties rank number the bestseller rank of the product position number the position of the product on the page (not the same as rank , which gives the bestseller rank across all pages) title string the product name sub title object subtitle object the subtitle object contains details of the information shown in the subtitle directly underneath the product title text string the text of the subtitle typically the brand name or author of the product i e "samsung" link string the link of the subtitle typically to the manufacturer or author page on the amazon domain variant string the variant or type of the product as shown on the bestsellers page asin string the amazon product id (asin) for the product link string the product page link image string a link to the image of the product rating number the overall rating of the product, out of 5 ratings total number the total number of customer ratings the product has received price object price object the price object contains details about the products pricing, as shown underneath the product title in the case of a range price (i e $4 99 $9 99 ) being shown then price reflects the lower bound price symbol string the currency symbol, i e $ for usd value number the price of the offer currency string the currency of the offer as a iso 4217 https //en wikipedia org/wiki/iso 4217 currency code raw string the raw price as displayed on the offer listing price lower object the lower bound price in the case of a price range being shown (null if a singular price is shown) for example if the price range shown was $4 99 $9 99 then price lower would be $4 99 the properties of the price lower is the same as the price identical to those of the price object, described above price upper object the upper bound price in the case of a price range being shown (null if a singular price is shown) for example if the price range shown was $4 99 $9 99 then price upper would be $9 99 the properties of the price upper is the same as the price identical to those of the price object, described above pagination object an object containing details of the current bestsellers page and the total number of pages that are available to paginate you should specify the page number in your request's page parameter https //docs trajectdata com/rainforestapi/product data api/parameters/bestsellers current page number the current page number total pages number the total number of pages available bestsellers info object an object containing category and other information on the current current bestsellers page current category object an object describing the name , link and id of the current bestsellers category parent category object an object describing the name , link and id of the parent bestsellers category child categories array an array of objects describing the name , link and id of the child bestsellers categories next steps bestsellers parameters https //docs trajectdata com/rainforestapi/product data api/parameters/bestsellers