# Amazon Price Monitor — Price History & Drop Alerts (`oneary/amazon-price-monitor`) Actor

💰 Track Amazon product prices automatically — get notified when prices drop, monitor historical trends, and never overpay again. Extract current price, ratings, availability, seller info, and discount data. SaaS-ready with subscription tiers starting at $10/month. Perfect for savvy shopper

- **URL**: https://apify.com/oneary/amazon-price-monitor.md
- **Developed by:** [Luan M.](https://apify.com/oneary) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$18.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Amazon Price Monitor

**Track Amazon prices, get email alerts on drops, and build historical price charts — all automated.**

![Amazon Price Monitor](https://placehold.co/800x400/232f3e/FF9900?text=Amazon+Price+Monitor&font=montserrat)

### 🚀 Overview

Amazon Price Monitor is a powerful Apify actor that scrapes Amazon product pages to extract pricing, ratings, availability, and seller data. It tracks price changes over time, alerts you when prices drop, and helps you make smarter buying decisions.

**Use cases:**
- 🏪 **E-commerce sellers** — monitor competitor pricing and adjust your strategy
- 🛒 **Savvy shoppers** — get notified when wishlist items go on sale
- 📊 **Market researchers** — build historical price datasets for analysis

### ✨ Features

| Feature | Description |
|---|---|
| **Price Extraction** | Captures current price, currency, and discount info |
| **Rating & Reviews** | Extracts star rating and total review count |
| **Availability Check** | Detects in-stock, out-of-stock, and pre-order status |
| **ASIN & Seller** | Identifies product ASIN and seller name |
| **Category Detection** | Extracts breadcrumb category path |
| **Price History** | Tracks price changes across runs (local in-memory, ready for KV store) |
| **Price Alerts** | Detects significant price drops (5%+) and logs notifications |
| **Price Range Filter** | Skip products outside your desired price window |
| **Proxy Support** | Residential proxy rotation to avoid blocks |
| **SaaS Ready** | Built for Apify platform with $10–50/month subscription model |

### 💰 Pricing Model (SaaS)

This actor is designed for the Apify Store with a subscription pricing model:

| Tier | Price | Features |
|---|---|---|
| **Starter** | $10/month | Up to 100 products, daily checks, email alerts |
| **Pro** | $25/month | Up to 500 products, hourly checks, email + SMS alerts |
| **Enterprise** | $50/month | Unlimited products, real-time checks, webhook integrations, API access |

### 📥 Input

Configure the actor with these parameters:

| Field | Type | Default | Description |
|---|---|---|---|
| `startUrls` | `array` | Required | Amazon product URLs or search result pages |
| `maxProducts` | `integer` | `50` | Max products to scrape per run (1–500) |
| `proxyConfiguration` | `object` | Residential proxy | Apify proxy config for geotargeting |
| `minPrice` | `number` | `5` | Minimum product price to track ($) |
| `maxPrice` | `number` | `5000` | Maximum product price to track ($) |
| `notifyOnChange` | `boolean` | `true` | Send alert when price changes ≥5% |

### 📤 Output

The actor outputs a dataset of products with this schema:

```json
{
  "productName": "Sony WH-1000XM5 Wireless Headphones",
  "price": 328.00,
  "currency": "USD",
  "rating": 4.6,
  "reviewsCount": 24580,
  "availability": "In Stock",
  "asin": "B0C1H6Z3NQ",
  "seller": "Amazon.com",
  "category": "Headphones",
  "url": "https://www.amazon.com/dp/B0C1H6Z3NQ",
  "scrapedAt": "2024-01-15T10:30:00.000Z",
  "priceHistory": [
    { "date": "2024-01-10T08:00:00.000Z", "price": 348.00 },
    { "date": "2024-01-15T10:30:00.000Z", "price": 328.00 }
  ]
}
````

### 🏗️ Architecture

```
┌─────────────┐     ┌──────────────────┐     ┌───────────────┐
│ Start URLs  │────▶│ PlaywrightCrawler│────▶│ Dataset       │
└─────────────┘     │  (Headless Chrom)│     └───────────────┘
                    │                  │     ┌───────────────┐
                    │  • Extract data  │────▶│ Price History │
                    │  • Price filters │     │  (KV Store)   │
                    │  • Proxy rotate  │     └───────────────┘
                    └──────────────────┘
```

### 🛠️ Local Development

```bash
## Install dependencies
npm install

## Install Playwright browsers
npx playwright install chromium

## Run locally (requires Apify token)
npm start
```

### 🔧 Technical Details

- **Runtime:** Node.js 20+
- **Framework:** Crawlee + Playwright (PlaywrightCrawler)
- **Browser:** Headless Chromium
- **Proxy:** Apify Proxy with residential group support
- **Rate Limiting:** Automatic retry with exponential backoff
- **Selector Strategy:** Multi-fallback price selectors for Amazon's dynamic layout

#### Price Selector Fallbacks

The crawler attempts price extraction in this order:

1. `.a-price .a-price-whole` + `.a-price .a-price-fraction` (primary)
2. `span.a-price[data-a-size="xl"] span.a-offscreen` (deal price)
3. `#price_inside_buybox`, `#priceblock_ourprice`, `#priceblock_dealprice` (legacy)

### ⚠️ Limitations

- Amazon may block aggressive scraping — use residential proxies and reasonable concurrency
- Price selectors may break if Amazon changes its DOM structure
- Price history is currently in-memory; production deployments should use Apify KV Store

### 📄 License

Apache 2.0 — see [LICENSE](LICENSE)

# Actor input Schema

## `startUrls` (type: `array`):

List of Amazon product page URLs or search result URLs to monitor.

## `maxProducts` (type: `integer`):

Maximum number of products to scrape per run.

## `proxyConfiguration` (type: `object`):

Apify proxy configuration for geotargeting and avoiding blocks.

## `minPrice` (type: `number`):

Only track products with a price above this value.

## `maxPrice` (type: `number`):

Only track products with a price below this value.

## `notifyOnChange` (type: `boolean`):

Send email notification when a tracked product's price changes significantly.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.amazon.com/dp/B0C1H6Z3NQ"
    }
  ],
  "maxProducts": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "minPrice": 5,
  "maxPrice": 5000,
  "notifyOnChange": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.amazon.com/dp/B0C1H6Z3NQ"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("oneary/amazon-price-monitor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.amazon.com/dp/B0C1H6Z3NQ" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("oneary/amazon-price-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.amazon.com/dp/B0C1H6Z3NQ"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call oneary/amazon-price-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=oneary/amazon-price-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Amazon Price Monitor — Price History & Drop Alerts",
        "description": "💰 Track Amazon product prices automatically — get notified when prices drop, monitor historical trends, and never overpay again. Extract current price, ratings, availability, seller info, and discount data. SaaS-ready with subscription tiers starting at $10/month. Perfect for savvy shopper",
        "version": "1.0",
        "x-build-id": "KBErVA8x6GgEd1FqZ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/oneary~amazon-price-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-oneary-amazon-price-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/oneary~amazon-price-monitor/runs": {
            "post": {
                "operationId": "runs-sync-oneary-amazon-price-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/oneary~amazon-price-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-oneary-amazon-price-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "List of Amazon product page URLs or search result URLs to monitor.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxProducts": {
                        "title": "Max Products",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of products to scrape per run.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Apify proxy configuration for geotargeting and avoiding blocks."
                    },
                    "minPrice": {
                        "title": "Minimum Price ($)",
                        "minimum": 0,
                        "type": "number",
                        "description": "Only track products with a price above this value.",
                        "default": 5
                    },
                    "maxPrice": {
                        "title": "Maximum Price ($)",
                        "minimum": 0,
                        "type": "number",
                        "description": "Only track products with a price below this value.",
                        "default": 5000
                    },
                    "notifyOnChange": {
                        "title": "Notify on Price Change",
                        "type": "boolean",
                        "description": "Send email notification when a tracked product's price changes significantly.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```