# eBay Price Tracker — Price Drops, Stock & Auction Monitor (`apimy/ebay-price-tracker`) Actor

- **URL**: https://apify.com/apimy/ebay-price-tracker.md
- **Developed by:** [Nikita Iakovlev](https://apify.com/apimy) (community)
- **Features:** Limited permissions
- **Stats:** 7 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.80 / 1,000 listing checkeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## eBay Price Tracker — Price Drops, Stock & Auction Monitor

Watch eBay listings **between runs**. Paste listing links, run the Actor on a schedule, and every run tells
you what changed since the last one: price drop or rise, units sold, stock left, watchers gained, new bids,
listing ended or came back. No login, no cookies, no eBay account — works on 18 eBay sites.

Built for resellers watching competitors, dropshippers watching suppliers, collectors watching auctions,
deal hunters and AI agents that need structured "did the price move?" data instead of screenshots.

### What you get

One row per tracked listing per run — always the full current state, plus the comparison with your previous run:

| Field | Example |
|---|---|
| `title` | Apple iPhone 15 Pro 256GB Unlocked |
| `status` | `active` or `ended` |
| `price`, `currency` | 449.99, USD |
| `previousPrice`, `priceChange`, `priceChangePercent` | 499.99, −50, −10 |
| `alerts` | `["price-drop", "sold-units"]` |
| `changed` | true |
| `quantityAvailable`, `quantitySold`, `quantitySoldDelta` | 12, 235, +5 |
| `watchers`, `watchersDelta` | 44, +3 |
| `bidCount`, `bidCountDelta`, `endsAt` | 7, +4, 2026-11-20T18:00:00Z |
| `condition`, `listingType`, `shippingPrice`, `freeShipping` | New, fixed price, 0, true |
| `sellerUsername`, `sellerFeedbackScore`, `sellerPositivePercent` | gamestore, 5120, 99.2 |
| `brand`, `model`, `itemLocation`, `imageUrl`, `url`, `site` | … |
| `source` | `ebay-api` or `everyinfra` — which data route produced this check |

The `alerts` column is the point of this Actor. Filter rows on it (or on `changed`) and you see only movement:

- `price-drop` / `price-up` — the price moved by at least your threshold (default 5%)
- `price-change` — it moved, but less than the threshold
- `ended` — the listing just ended; `back-on-sale` — it is live again
- `sold-units` — the seller sold units since your last run
- `new-bids` — an auction got new bids
- `low-stock` — 3 or fewer units left
- `first-check` — first time this Actor sees the listing (nothing to compare yet)

The **SUMMARY** record (Storage → Key-value store) counts listings checked, listings with changes and failed
checks. The Actor remembers listings per your account, so the comparison works across runs and schedules
without any setup.

### How to use it

1. Put one listing per line in **eBay listings to track** — a full link like
   `https://www.ebay.com/itm/123456789012` (a link with the title in it works too) or just the item number.
2. Set the **price alert threshold** (default 5%).
3. Click **Start**. The first run records the starting point (`first-check`); every next run reports changes.
4. To make it a real monitor, open **Schedules** in the Apify Console and run it hourly or daily. Each run
   writes fresh rows, so your dataset becomes a price history.

Example input:

```json
{
  "itemUrls": ["https://www.ebay.com/itm/366817573751"],
  "priceDropPercent": 5
}
```

### Pricing

Pay per event: a small fee per run start plus a fee per listing checked. A check is charged whether or not
the listing changed — the Actor does the same work either way — and rows with `error` or `notice` are free.
Failed checks are never charged.

Checking 100 listings once a day costs about **$8/month** on the Free tier — less on paid Apify plans.

### eBay sites

ebay.com, ebay.co.uk, ebay.de, ebay.ca, ebay.com.au, ebay.fr, ebay.it, ebay.es, ebay.nl, ebay.ie, ebay.at,
ebay.ch, ebay.com.sg, ebay.com.my, ebay.ph, ebay.pl, befr.ebay.be, benl.ebay.be. The site is taken from each
link, so one run can track listings on several sites at once.

### Where the data comes from, and honesty

Each check uses one of two independent routes, and every row says which one in its `source` column:

- **`ebay-api`** (primary) — the official eBay Browse API. Fast and reliable. It reports stock and units
  sold as eBay's own estimates, and it returns `watchers` only for some listings — when eBay does not
  expose the watch count there, the field is `null`, never a made-up zero. `sellerUrl` is not provided
  by the API and stays `null` on this route.
- **`everyinfra`** (fallback) — a partner data source reading the listing page. Used automatically when
  the official API is unavailable or its daily allowance is spent.

Because the two routes measure `quantitySold` and `watchers` slightly differently, a delta computed
across a route switch can be off by a little; the `source` column of the current and previous run
(`SUMMARY` keeps counts per route) tells you when that happened.

Other limits:

- An auction's `price` is the current bid. For sold-price history of **completed** sales, use the companion
  Actor below.
- A listing the official API reports as gone: if this Actor saw it alive before, you get a charged row with
  `status: "ended"`; if it has never seen it, you get a free `notice` row — the number may be wrong or the
  listing removed long ago.
- A removed or unrecognized listing produces a free `error` or `notice` row with a plain explanation.
- On the Apify Free plan the Actor checks up to 3 listings per run. Any paid Apify plan removes the limit.

### Works together with

**[eBay Sold Listings Scraper](https://apify.com/apimy/ebay-sold-listings-scraper)** — real sold prices and
comps by keyword. The natural workflow: look up what an item actually sells for with the Sold Listings
Scraper, decide your target price, then paste the live listings you care about into this Actor and let it
tell you when the price gets there.

### Support

Something missing — a field, a site, a new alert type? Open an issue on the Actor page; we read every one
and usually answer within a day.

# Actor input Schema

## `itemUrls` (type: `array`):

One listing per line: a full link like https://www.ebay.com/itm/123456789012 (any title in the link is fine) or just the item number. Works on 18 eBay sites — ebay.com, ebay.co.uk, ebay.de, ebay.fr and others. Duplicates are checked once.

## `priceDropPercent` (type: `integer`):

Flag "price-drop" or "price-up" when the price moved by at least this percent since your previous run. Smaller moves are still reported as "price-change". 0 flags every move.

## `maxItems` (type: `integer`):

Upper limit of listings checked in one run. Protects you from an unexpectedly large bill.

## Actor input object example

```json
{
  "itemUrls": [
    "https://www.ebay.com/itm/366817573751",
    "https://www.ebay.com/itm/800855794517",
    "https://www.ebay.com/itm/198795442860"
  ],
  "priceDropPercent": 5,
  "maxItems": 100
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (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 = {
    "itemUrls": [
        "https://www.ebay.com/itm/366817573751",
        "https://www.ebay.com/itm/800855794517",
        "https://www.ebay.com/itm/198795442860"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("apimy/ebay-price-tracker").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 = { "itemUrls": [
        "https://www.ebay.com/itm/366817573751",
        "https://www.ebay.com/itm/800855794517",
        "https://www.ebay.com/itm/198795442860",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("apimy/ebay-price-tracker").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 '{
  "itemUrls": [
    "https://www.ebay.com/itm/366817573751",
    "https://www.ebay.com/itm/800855794517",
    "https://www.ebay.com/itm/198795442860"
  ]
}' |
apify call apimy/ebay-price-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apimy/ebay-price-tracker"
        }
    }
}
```

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/bGbFuEu7Xbgzk1NZt/builds/BgTdnrTmvTr06fg5d/openapi.json
