When making a request with the /bestsellers endpoint ScrapeIN returns results with the following properties:

📘

Note on Bestsellers Results

ScrapeIN retrieves Bestsellers results from various types of Amazon Bestseller pages, including Bestsellers, Hot New Releases, Movers & Shakers, Most Wished For, and Gift Ideas.

JSON Example

{
  "bestsellers": [
    {
      "rank": 1,
      "position": 1,
      "title": "Iron Flame (The Empyrean, 2)",
      "asin": "1649374178",
      "link": "https://www.amazon.com/Iron-Flame-Empyrean-Rebecca-Yarros/dp/1649374178/ref=zg_bs_g_books_sccl_1/130-1266096-6041739?psc=1",
      "sub_title": {
        "text": "Rebecca Yarros",
        "link": "https://www.amazon.com/Rebecca-Yarros/e/B00HYKBU1W/ref=zg_bs_g_books_bl_sccl_1/130-1266096-6041739"
      },
      "variant": "Hardcover",
      "image": "https://images-na.ssl-images-amazon.com/images/I/A1bc9KkHtsL._AC_UL300_SR300,200_.jpg",
      "price": {
        "symbol": "$",
        "value": 18.53,
        "currency": "USD",
        "raw": "$18.53"
      },
      "current_category": {
        "name": "Books",
        "link": "https://www.amazon.com/Best-Sellers-Books/zgbs/books",
        "id": "books"
      },
      "parent_category": {
        "name": "Any Department",
        "link": "https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bs_unv_books_0_1",
        "id": "zgbs"
      }
    },
    {
      "rank": 2,
      "position": 2,
      "title": "Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones",
      "asin": "0735211299",
      "link": "https://www.amazon.com/Atomic-Habits-Proven-Build-Break/dp/0735211299/ref=zg_bs_g_books_sccl_2/130-1266096-6041739?psc=1",
      "sub_title": {
        "text": "James Clear",
        "link": "https://www.amazon.com/James-Clear/e/B07DJTJC3X/ref=zg_bs_g_books_bl_sccl_2/130-1266096-6041739"
      },
      "variant": "Hardcover",
      "image": "https://images-na.ssl-images-amazon.com/images/I/81bGKUa1e0L._AC_UL300_SR300,200_.jpg",
      "rating": 4.8,
      "ratings_total": 110362,
      "price": {
        "symbol": "$",
        "value": 12.96,
        "currency": "USD",
        "raw": "$12.96"
      },
      "current_category": {
        "name": "Books",
        "link": "https://www.amazon.com/Best-Sellers-Books/zgbs/books",
        "id": "books"
      },
      "parent_category": {
        "name": "Any Department",
        "link": "https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bs_unv_books_0_1",
        "id": "zgbs"
      }
    },
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 2
  },
  "bestsellers_info": {
    "title": "Books",
    "current_category": {
      "name": "Books",
      "link": "https://www.amazon.com/Best-Sellers-Books/zgbs/books",
      "id": "books"
    },
    "parent_category": {
      "name": "Any Department",
      "link": "https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bs_unv_books_0_1",
      "id": "zgbs"
    },
    "child_categories": [
      {
        "name": "Arts & Photography",
        "link": "https://www.amazon.com/Best-Sellers-Books-Arts-Photography/zgbs/books/1/ref=zg_bs_nav_books_1",
        "id": "1"
      },
    ]
  }
}

Amazon Deals and Bestsellers API returns the following properties for requests with the /bestsellers endpoint:

JSON Structure

The JSON structure returned by the Amazon API includes required elements, such as request_parameters, request_metadata, pagination, as described in the Results Amazon Data API section, as well as those specific to Amazon bestsellers data, which are described below.

bestsellers

An array of Bestseller Result objects, representing each product listed. Here are the properties of each Bestseller Result object:

• rank: The bestseller rank of the product across all pages.
• position: The position of the product on the page.
• title: The product name.
• sub_title: An object containing details of the subtitle shown below the product title.
  • text: The text of the subtitle, typically the brand name or author.
  • link: The link associated with the subtitle, usually to the manufacturer or author page.
• variant: The variant or type of the product as displayed on the Bestsellers page.
• asin: The Amazon product ID (ASIN) for the product.
• link: The product page link.
• image: A link to the product image.
• rating: The overall rating of the product, out of 5.
• ratings_total: The total number of customer ratings the product has received.
• price: An object containing details about the product's pricing as displayed under the title. If a price range is displayed (e.g., $4.99 - $9.99), the price property represents the lower-bound price.
  • symbol: The currency symbol (e.g., $ for USD).
  • value: The price of the offer.
  • currency: The currency of the offer and is ISO 4217 code.
  • raw: The raw price as displayed on the offer listing.
• price_lower: An object representing the lower-bound price in case of a price range (null if a singular price is shown). The properties of price_lower are the same as the price object described above. That is for instance, if the displayed price range is $4.99 - $9.99, the price_lower would be $4.99.
• price_upper: An object representing the upper-bound price in case of a price range (null if a singular price is shown). The properties of price_upper are the same as the price object described above. That is for instance, if the displayed price range is $4.99 - $9.99, the upper would be $9.99.

pagination

The pagination object includes information about the current bestsellers page and the total number of available pages. To paginate, you need to specify the page number in the page parameter of your request.

• current_page: The current page number.
• total_pages: The total number of pages available.

bestsellers_info

An object contains information about

• current category, including the name, link, and idof the current Bestsellers category.
• parent_category, describing the name, link, and id of the parent Bestsellers category.
• child_categories - an array that includes objects that provide the name, link, and id of the child Bestsellers categories.