Bestsellers

2 min

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:

{
  "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