Bestsellers

2min

Bestsellers Results
When making a request with the  type  parameter 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, or by using the  url  parameter.
Rainforest supports all types of Amazon Bestseller pages, bestsellers, new releases, movers & shakers, most wished for and gift ideas.
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"
      }
    ]
  }
}
{
  "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 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 .
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﻿

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 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 . 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.

Updated 05 Sep 2024

Did this page help you?

Deals

Seller Profile