# Amazon Offers & Hijacker Monitor: Sellers & Buy Box Alerts (`vncntlabs/amazon-offers-monitor`) Actor

Daily check of who sells your ASINs. Flags possible unauthorized new-condition sellers, Buy Box changes and prices below your floor, with an allowlist and one plain verdict per ASIN: ACT, WATCH or OK. Keeps used resellers apart. No login.

- **URL**: https://apify.com/vncntlabs/amazon-offers-monitor.md
- **Developed by:** [VNCNT Labs](https://apify.com/vncntlabs) (community)
- **Categories:** E-commerce, Automation, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 asin checkeds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Amazon Offers & Hijacker Monitor: Sellers & Buy Box Alerts

Most sellers find out about a new seller on their listing weeks late, from a bad review or a sudden drop in Buy Box
sales. This Actor checks who sells your ASINs and tells you **only what changed** since the last check, with one plain
verdict per ASIN: **ACT**, **WATCH** or **OK**.

It keeps **new-condition** third-party offers (the real risk on a brand or KDP listing) apart from **used**
resellers, which almost every book has. A KDP coloring book we tested had 17 offers: 16 used copies from thrift
resellers and 1 new copy from Amazon. A plain "other sellers" count would call that 16 problems. This calls it OK.

- **Allowlist:** your own store, your distributors and Amazon itself never alert.
- **Baseline first:** the first check of an ASIN saves what's there and sends no alerts.
- **Debounced Buy Box:** a new Buy Box holder is reported as "likely" once and "confirmed" only after two checks in
  a row, so one odd read doesn't wake you up.
- **No login, no browser extension, no monthly subscription.** Pay per ASIN checked.

### Who it's for

- **KDP authors and self-publishers:** know when a new-condition copy of your book shows up from a seller you don't know.
- **Small brands and Merch/private-label sellers:** see a new seller or a lost Buy Box the next morning, not next month.
- **Agencies:** one scheduled monitor per client, one alert when something needs a look.

### Verdicts

| Verdict | When | What to do |
| --- | --- | --- |
| **ACT** | A new-condition seller that is not on your allowlist starts selling or takes the Buy Box (confirmed), or a new-condition price drops below your floor | Test buy, then report if needed (see below) |
| **WATCH** | A new used, collectible or renewed seller; a new seller with no condition shown; the Buy Box price moves by your threshold (default 5%); the Buy Box holder likely changed (seen once) | Look when you have a minute |
| **OK** | Nothing that needs you (allowlisted sellers' changes and sellers that left are kept as notes) | Nothing |
| **BASELINE** | First check of this ASIN in this monitor | Nothing; alerts start from the next run |

**ACT next step, in plain words:** do a test buy from the offer and check the item and packaging. If it isn't genuine
or doesn't match your listing, report it through Amazon Brand Registry (Report a Violation), or Amazon's Report
Infringement form if you aren't enrolled. If the seller turns out to be authorized, add them to the allowlist and they
never alert again.

This Actor never calls a seller counterfeit or a hijacker. A flag means "possible unauthorized new-condition seller,
verify with a test buy". It is data, not a legal finding.

### Set up a daily check with an alert (one screen)

1. **Run it once** with your ASINs and a `monitorName` (for example `kdp-books`). That run saves the baseline.
2. Click **Save as a new task** at the top of the input form, so the same ASINs and `monitorName` are used every time.
3. **Alerts by webhook (easiest):** paste a Slack or Discord incoming-webhook URL, or a Zapier/Make "catch hook" URL,
   into **Alert webhook URL**. The Actor posts a short message only when something is ACT (or WATCH, your choice).
   Quiet days send nothing.
4. **Or alerts by email:** in the task, open **Integrations** and add **Send results email via Gmail**. It emails
   after every successful run, so also turn on **Save only ASINs with changes**: the attached dataset is then empty
   on quiet days and lists only ACT and WATCH rows when something changed.
5. Open **Schedules** in Apify Console, click **Create new**, pick a daily time, and add your task.

Every run's plain-English summary is in the run's **OUTPUT** record (Storage → Key-value store → OUTPUT), and the
**Changes** dataset view lists ACT and WATCH rows first.

### How it works

- Offers come from DataForSEO's licensed Amazon sellers data (the "Other sellers on Amazon" list), not from scraping
  Amazon with your account.
- **State:** each run saves the sellers, featured offer and prices per ASIN in a named key-value store in *your*
  Apify account, called `offers-monitor-<your monitor name>`, one record per marketplace (`STATE-US`, `STATE-GB`...).
  The next run of the same monitor compares against it. Use a different `monitorName` for each list. Run one monitor
  at a time; two runs of the same monitor at once would overwrite each other's state.
- **Buy Box:** DataForSEO's sellers result has no explicit Buy Box field (we checked: the item types are only the
  featured offer and the other offers). So the Buy Box holder is the seller of the **featured offer**. A change is
  "likely" the first time and "confirmed" when the same new holder shows up on 2 checks in a row.
- **FBA or FBM:** the FBA flag in the data isn't reliable, so fulfillment comes from **Ships from**: shipped by Amazon
  \= `FBA` (or `Amazon` when Amazon is also the seller), shipped by anyone else = `FBM`.
- **Sellers leaving:** a seller missing from one check isn't reported as gone until it's missing from 2 checks in a
  row, so a short read never creates a fake "left" and "new seller" pair. Sellers gone for 45 days are forgotten.
- Matching uses the seller ID when Amazon shows one, else the seller name. Allowlist entries can be either.

### Input

| Field | What it does |
| --- | --- |
| `asins` | ASINs, ISBN-10s or Amazon product links. Up to 500 per run |
| `monitorName` | Names the saved state. Keep it the same on every scheduled run (default `my-asins`) |
| `marketplace` | Amazon site: US, GB, DE, FR, IT, ES, CA, MX, BR, JP, IN, AU, NL, SE, PL, TR, AE, SA, BE |
| `allowedSellers` | Authorized seller names or seller IDs for every ASIN |
| `allowAmazon` | Amazon itself never alerts (default on) |
| `brandAllowlists` | Per brand: `{"Brand A": {"asins": ["B0..."], "sellers": ["Brand A Official"]}}` |
| `asinSettings` | Per ASIN: `{"B0...": {"allowedSellers": ["Reseller X"], "floorPrice": 19.99}}` |
| `floorPrice` | New-condition offers below this are ACT (per-ASIN floors override). Used offers are ignored |
| `floorIncludesAmazon` | Also apply the floor to Amazon's own price (default off: Amazon sets its own discounts) |
| `priceChangePercent` | Buy Box price move that counts as WATCH (default 5, 0 = off) |
| `alertWebhookUrl` / `alertOn` | JSON POST to Slack, Discord, Zapier, Make or your URL, only when there's an ACT (or ACT/WATCH) |
| `onlyChanges` | Dataset holds only ACT and WATCH rows (empty on quiet days) |
| `includeOffers` | Full offer list in each row (default on) |
| `maxAsins` | Safety cap, default 100 (a few minutes); up to 500 within the default 1-hour timeout. Free Apify plans: 10 |
| `resetBaseline` | Start this monitor's ASINs over with a fresh baseline |

```json
{
  "asins": ["1661264107", "https://www.amazon.com/dp/B07YHZR726"],
  "monitorName": "kdp-books",
  "allowedSellers": ["My Author Store"],
  "floorPrice": 9.99,
  "alertWebhookUrl": "https://hooks.slack.com/services/..."
}
```

### Output

One row per ASIN. A later check that found a new seller (illustration; seller names changed):

```json
{
  "asin": "1661264107", "verdict": "ACT",
  "title": "100 Flowers: An Adult Coloring Book with Bouquets, Wreaths, Swirls...",
  "whatChanged": "Possible unauthorized new-condition seller: Example Deals Co at $7.50, FBA. Verify with a test buy.",
  "nextStep": "Do a test buy from this offer and check the item and packaging. If it isn't genuine ...",
  "openIssues": ["Possible unauthorized new-condition seller: Example Deals Co at $7.50, FBA, listed since 2026-11-18. Verify with a test buy."],
  "buyBox": {"sellerName": "Amazon.com", "price": 11.22, "fulfillment": "Amazon", "isAuthorized": true,
             "method": "inferred from the featured offer (DataForSEO has no explicit Buy Box field)"},
  "sellersCount": 15, "thirdPartyNewOffers": 1, "unauthorizedNewOffers": 1, "usedConditionOffers": 13,
  "lowestNewPrice": 7.5, "checkNumber": 2, "baselineDate": "2026-11-17", "charged": true
}
```

The real first check of that KDP book (Nov 17 2026, offers list shortened). 17 offers from 14 sellers: 13 sell used
copies, the only new copy is Amazon's, so nothing is open:

```json
{
  "asin": "1661264107", "verdict": "BASELINE",
  "title": "100 Flowers: An Adult Coloring Book with Bouquets, Wreaths, ...",
  "whatChanged": "Baseline saved; no alerts on the first check.",
  "openIssues": [],
  "buyBox": {"sellerName": "Amazon.com", "price": 11.22, "condition": "New", "fulfillment": "Amazon", "isAuthorized": true},
  "sellersCount": 14, "newConditionOffers": 1, "usedConditionOffers": 13,
  "thirdPartyNewOffers": 0, "unauthorizedNewOffers": 0, "lowestNewPrice": 11.22, "currency": "USD",
  "checkNumber": 1, "baselineDate": "2026-11-17", "dataAsOf": "2026-11-17 14:49:57 +00:00",
  "offers": [
    {"sellerName": "Amazon.com", "isMainOffer": true, "condition": "New", "price": 11.22, "shipsFrom": "Amazon.com", "fulfillment": "Amazon"},
    {"sellerName": "Goodwill Retail Services, Inc.", "isMainOffer": false, "condition": "Used - Acceptable", "price": 2.57, "shipsFrom": "Goodwill Retail Services, Inc.", "fulfillment": "FBM"}
  ]
}
```

The run's OUTPUT record has a one-paragraph summary you can paste anywhere, plus counts, the list of changes, what
was charged and whether the webhook was sent.

### Pricing

- **$0.01 per ASIN checked** (event `asin-checked`): an ASIN whose offers were read.
- **$0.005 per run** start fee (`apify-actor-start`).
- **Not charged:** ASINs with no offer data (unavailable, wrong marketplace, not an ASIN), provider errors, invalid
  inputs, duplicates.
- Example: a daily check of 20 ASINs = $0.005 + $0.20 = **$0.205 per day**, about $6 a month.
- Set a maximum charge per run and the Actor stops there.

### Use from AI agents (MCP)

AI assistants such as Claude, ChatGPT and Cursor can run this Actor through [Apify's MCP server](https://docs.apify.com/platform/integrations/mcp) (`https://mcp.apify.com`). Runs use your own Apify account and are charged at the prices on this page.

- **Actor name:** `vncntlabs/amazon-offers-monitor`
- **Server URL with only this tool:** `https://mcp.apify.com?tools=vncntlabs/amazon-offers-monitor`

```json
{ "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=vncntlabs/amazon-offers-monitor" } } }
```

Example prompt: *"Use vncntlabs/amazon-offers-monitor with monitorName kdp-books to check ASIN 1661264107 and tell me
if any new-condition seller that isn't Amazon is selling it."*

### FAQ

**Do I need an Amazon login, SP-API keys or Brand Registry?** No. Brand Registry is only where you report a problem.

**Why didn't my first run alert?** The first check of each ASIN is the baseline. Anything already there is listed in
`openIssues` (and in the summary) so you can review it, but it doesn't alert. Alerts start with the next run.

**Is a flagged seller a counterfeiter?** Not necessarily. Many new-condition third-party sellers are legitimate
resellers or arbitrage sellers. That's why the next step is a test buy, and why the allowlist exists.

**How fresh is the data? How long does a run take?** Each row has `dataAsOf`, the time the offer list was read. The
data provider answers each ASIN in about 1-2 minutes, in parallel, so a few ASINs take about 2 minutes and our 500-ASIN
test runs took 5.5 and 7 minutes, well inside the default 1-hour timeout.

**Why is an ASIN "no_data"?** Amazon showed no offers at all (the product is unavailable or has no Buy Box and no
other sellers), it's the wrong marketplace, or it isn't an ASIN. Those rows are free and the saved state is left as is.

**Does it see every offer?** It sees the offers Amazon shows in the "Other sellers on Amazon" list for that
marketplace and delivery location, which can differ slightly from what a shopper elsewhere sees.

**Can I monitor several marketplaces?** Yes. Each marketplace has its own saved state inside the monitor.

**Is this legal to use?** The data is public offer information (business names, prices, condition), delivered
through a licensed data API. No personal data. Not affiliated with or endorsed by Amazon.

# Actor input Schema

## `asins` (type: `array`):

Your listings, KDP books or brand catalog: 10-character ASINs/ISBN-10s or Amazon product links. Up to 500 per run (default cap 100, see Max ASINs).

## `monitorName` (type: `string`):

Names the saved state this run compares against. Keep it the same on every scheduled run. Use a different name for each separate list (e.g. "kdp-books", "brand-a"). The first run of a name only saves a baseline.

## `marketplace` (type: `string`):

Which Amazon site to check. Each marketplace keeps its own saved state.

## `allowedSellers` (type: `array`):

Seller names exactly as Amazon shows them, or seller IDs (e.g. A1B2C3D4E5F6G7). These never alert. Amazon itself is allowed by default (see below).

## `allowAmazon` (type: `boolean`):

On by default: offers sold by Amazon (Amazon.com, Amazon.de, Amazon Resale and so on) never alert. Turn off only if Amazon is not supposed to sell your product.

## `brandAllowlists` (type: `object`):

Optional. Group ASINs by brand and list that brand's authorized sellers: {"Brand A": {"asins": \["B0...", "B0..."], "sellers": \["Brand A Official", "Reseller X"]}}. A brand with no "asins" applies to every ASIN.

## `asinSettings` (type: `object`):

Optional. {"B0XXXXXXXX": {"allowedSellers": \["Reseller X"], "floorPrice": 19.99}}. Adds sellers for one ASIN and sets its own floor.

## `floorPrice` (type: `number`):

Optional. A new-condition offer below this price is an ACT alert (e.g. your minimum advertised price). Per-ASIN floors override it. Used offers are ignored.

## `floorIncludesAmazon` (type: `boolean`):

Off by default, because Amazon sets its own retail discounts (e.g. on KDP books) and you can't act on them.

## `priceChangePercent` (type: `integer`):

A WATCH alert when the featured (Buy Box) price moves at least this much since the previous check. 0 turns it off.

## `alertWebhookUrl` (type: `string`):

Optional. Slack or Discord incoming webhook, Zapier/Make catch hook, or any URL that accepts a JSON POST. Called only when there is something to alert (see Alert on). Nothing is sent on quiet days.

## `alertOn` (type: `string`):

Which verdicts call the webhook.

## `onlyChanges` (type: `boolean`):

On: the dataset holds only ACT and WATCH rows, so an empty dataset means nothing changed. Off: one row per ASIN (changes sort to the top).

## `includeOffers` (type: `boolean`):

Adds the full offer list (seller, condition, price, ships from, FBA/FBM, rating) to each ASIN row.

## `maxAsins` (type: `integer`):

Safety cap. The default 100 finishes in a few minutes; up to 500 is supported with the default 1-hour timeout. Free Apify plans: 10.

## `resetBaseline` (type: `boolean`):

Start over: this run saves a fresh baseline for its ASINs and sends no alerts.

## Actor input object example

```json
{
  "asins": [
    "1661264107",
    "B07YHZR726"
  ],
  "monitorName": "my-asins",
  "marketplace": "US",
  "allowAmazon": true,
  "brandAllowlists": {},
  "asinSettings": {},
  "floorIncludesAmazon": false,
  "priceChangePercent": 5,
  "alertOn": "watch",
  "onlyChanges": false,
  "includeOffers": true,
  "maxAsins": 100,
  "resetBaseline": false
}
```

# Actor output Schema

## `changes` (type: `string`):

No description

## `overview` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `all` (type: `string`):

No description

# 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 = {
    "asins": [
        "1661264107",
        "B07YHZR726"
    ],
    "monitorName": "my-asins",
    "brandAllowlists": {},
    "asinSettings": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("vncntlabs/amazon-offers-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 = {
    "asins": [
        "1661264107",
        "B07YHZR726",
    ],
    "monitorName": "my-asins",
    "brandAllowlists": {},
    "asinSettings": {},
}

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

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

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

```

## CLI example

```bash
echo '{
  "asins": [
    "1661264107",
    "B07YHZR726"
  ],
  "monitorName": "my-asins",
  "brandAllowlists": {},
  "asinSettings": {}
}' |
apify call vncntlabs/amazon-offers-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vncntlabs/amazon-offers-monitor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fokeieFwszhsznHqA/builds/rflfpx92xgbitzqqH/openapi.json
