Amazon Deals

ScrapeIN Amazon Deals API Response Description

When making a request with the /deals endpoint ScrapeIN returns Lightning Deals, Daily Deals, and Goldbox Deals based on the specified category_id and amazon_domain parameters.

A table displays product pricing information from the Deals category on Amazon. The table includes details like product name, price, and availability, obtained from the ScrapeIN Amazon Data API response. The information is presented in a clear and organized manner, facilitating easy comprehension.

ScrapeIN retrieves results from the deals listing pages on Amazon with the following properties:

JSON Example

{
  "deals_results": [
    {
      "position": 1,
      "link": "https://www.amazon.com/deal/926c6b9e",
      "asin": "B08F5LQCYP",
      "is_lightning_deal": true,
      "deal_type": "LIGHTNING_DEAL",
      "starts_at": "2023-06-27T15:00:00.367Z",
      "ends_at": "2023-07-05T15:00:00.367Z",
      "type": "multi_item",
      "title": "Amazon Fire HD 10 Tablet",
      "image": "https://m.media-amazon.com/images/I/41J7DAYrjRS.jpg",
      "deal_price_lower": {
        "value": 74.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "74.99"
      },
      "deal_price_upper": {
        "value": 89.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "89.99"
      },
      "deal_price": {
        "value": 74.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "74.99 - 89.99",
        "name": "Deal Price"
      },
      "list_price_lower": {
        "value": 149.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "149.99"
      },
      "list_price_upper": {
        "value": 189.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "189.99"
      },
      "list_price": {
        "value": 149.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "149.99 - 189.99",
        "name": "List Price"
      },
      "current_price_lower": {
        "value": 149.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "149.99"
      },
      "current_price_upper": {
        "value": 189.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "189.99"
      },
      "current_price": {
        "value": 149.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "149.99 - 189.99",
        "name": "Current Price"
      },
      "merchant_name": "Amazon.com",
      "free_shipping": false,
      "is_prime": true,
      "is_map": false,
      "deal_id": "926c6b9e",
      "seller_id": "ATVPDKIKX0DER",
      "description": "Shipped and Sold by Amazon.com",
      "rating": 4.58,
      "ratings_total": 113289
    },
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 26,
    "total_deals": 1501,
    "total_results": 1501
  }
}

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

JSON Structure

The JSON structure returned by the Amazon Deals and Bestsellers 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 Deals data, which are described below.

deals_results

An array containing multiple objects, each representing a Deal retrieved from an Amazon page. These objects have properties that describe their attributes and provide relevant information. The properties are as follows:

  • position: The position of the result on the Deal listing page.
  • title: The product name.
  • type: Indicates whether it's a single-item deal or a multi-item range deal. In a multi-item deal, the link property will contain the URL to access all the products included in the deal. The asins_in_deal property will provide a list of all the ASINs associated with the Deal.
  • asin: The Amazon product ID (ASIN) for the product.
  • asins in deal: An array of ASINs for the products included in the multi-item Deal.
  • link: The product page link for single_item results or a link to the product-listing page for multi_item results.
  • is_ prime: Indicates if the product is Prime-eligible.
  • is_map: Indicates if the product is showing the manufacturer's advertised price (true) or not (false).
  • free_shipping: Indicates if the product is eligible for free shipping.
  • deal_id: The ID of the Deal.
  • description: The description of the product.
  • merchant_name: The name of the merchant.
  • image: A link to the product image.
  • deal_type: The category of the Deal as described by Amazon.
  • deal price: The deal price expressed as a price object which includes properties such as value, currency, symbol, raw price and name ("Deal Price"). If the deal includes a price range (minimum and maximum), additional price objects called deal_price_lower and deal_price_upper will be provided.
  • list price: The list price (RRP) expressed as a price object. If the deal includes a price range (minimum and maximum), additional price objects called deal_price_lower and deal_price_upper will be provided.
  • current_price: The current deal price is expressed as a price object. If the deal includes a price range (minimum and maximum), additional price objects called deal_price_lower and deal_price_upper will be provided.
  • starts_at: The start date and time of the deal.
  • ends_at: The end date and time of the deal.
  • rating: The product rating.
  • ratings_total: The total number of ratings for the product.
  • is_lightning_deal: Indicates if Amazon flags this deal as a "Lightning Deal".
  • seller_id: The ID of the Seller of the deal, which can be used to retrieve further information about the seller in other endpoints such as /seller_profile and /seller_products.

categories

An array that provides information about the Deals categories which are displayed on the Deals page. These categories can also be accessed through the Navigation API. Each object within the array contains the following properties:

  • name: Represents the name of the category, such as "Arts, Crafts & Sewing". It indicates the specific category under which deals are classified.
  • category_id: Represents the ID of the Deals category. This ID can be used in future requests with the /deals endpoint in the category_id parameter, to retrieve deals belonging to that particular category.

pagination

An object with the following details about the pagination of the category listing:

  • current_page: The current page number.
  • total_pages: The total number of pages available.
  • total_deals: The total number of deals available.
  • total_results: The total number of results shown across all pages.