--- title: Bestsellers slug: rainforestapi/product-data-api/results/bestsellers docTags: createdAt: 2024-07-30T18:56:10.491Z --- # 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). ![](https://apiimages.imgix.net/rainforestapi/images/png/docs/bestsellers.png?auto=format\&ixlib=react-9.5.1-beta.1\&w=600 "Bestsellers Page") An example of the JSON object returned from a Bestsellers request is shown below: ```json { "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.
-
1. `text`
2. `string`
3. The text of the subtitle - typically the brand name or author of the product i.e. "Samsung".
-
1. `link`
2. `string`
3. 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.
-
1. `symbol`
2. `string`
3. The currency symbol, i.e. `$` for USD.
-
1. `value`
2. `number`
3. The price of the Offer.
-
1. `currency`
2. `string`
3. The currency of the Offer as a [ISO 4217 ](https://en.wikipedia.org/wiki/ISO_4217)currency code.
-
1. `raw`
2. `string`
3. 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)