# eBay Price Tracker (`truefetch/ebay-price-tracker`) Actor

Track public eBay marketplace listings by keyword and country site. Export active-listing records with title, price, currency, condition, shipping text, seller signals, image, item URL, source URL, marketplace country, query, and rank for resale and marketplace analysis.

- **URL**: https://apify.com/truefetch/ebay-price-tracker.md
- **Developed by:** [TrueFetch](https://apify.com/truefetch) (community)
- **Categories:** E-commerce, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.11 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

> **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through them, TrueFetch may receive a commission at no extra cost to you.

**eBay Price Tracker is an active-listing search and asking-price API that collects source-linked eBay marketplace records across 17 country sites for resale analysts, developers, and data teams.**

- **17 selectable eBay marketplaces** preserve country-site and currency context for each search.
- **58 normalized listing fields** cover item identity, asking price, condition, shipping, seller signals, source links, and rank.
- **Active listings stay distinct from sold data:** the Actor does not present asking prices as completed-sale prices.
- **Current Store evidence:** 2 total users, 1 monthly active user, and no reviews were visible on 2026-07-21; these figures are dated, not quality guarantees.

[**Run the minimum 10-result test**](https://apify.com/truefetch/ebay-price-tracker?fpr=aiagentapi) · [**View API**](https://apify.com/truefetch/ebay-price-tracker/api?fpr=aiagentapi)

The smallest valid `max_results` value is 10. If 10 listing records are stored, the FREE-tier Actor event charge is at most $0.08900: one $0.01000 start plus 10 results at $0.00790 each, excluding separate Apify platform usage.

### What does eBay Price Tracker do?

eBay Price Tracker searches active public eBay listings for one keyword and one selected country marketplace. It converts publishable search results into a consistent 58-field Dataset with titles, current asking prices, currencies, condition, shipping text, seller signals, product images, item URLs, query context, and search rank when available. The normalized contract supports repeatable resale and marketplace analysis without treating every country site as a separate data model.

This Actor is not a completed-sales database, sold-price estimator, auction outcome feed, automatic alert service, or official eBay API. eBay itself distinguishes active listings from completed or ended listings in its [sold-items guidance](https://www.ebay.com/help/listings/default/finding-sold-items?id=4108). The Actor returns current active search results only, so a listed asking price must never be interpreted as the price a buyer ultimately paid.

### How do I run eBay Price Tracker?

1. Open [eBay Price Tracker in Apify Store](https://apify.com/truefetch/ebay-price-tracker?fpr=aiagentapi).
2. Enter a product, brand, part number, or marketplace search phrase.
3. Choose one of the 17 supported eBay country marketplaces.
4. Set `max_results` between 10 and 10,000, run the Actor, and inspect the default Dataset.

Use this minimum valid input for an industrial-equipment listing snapshot:

```json
{
  "keyword": "Grundfos UPS3 circulation pump",
  "country": "United Kingdom",
  "max_results": 10
}
```

`max_results` is the maximum number of active listing records stored for this single-market search. It is not a guaranteed total. Query relevance, marketplace inventory, removed listings, and source responses can reduce the number of publishable records.

### What data does eBay Price Tracker return?

Every stored record follows one 58-field schema. Optional values remain empty when a listing does not expose reliable data.

| Data group | Dataset fields |
| --- | --- |
| Images and listing content | `main_image`, `image_urls`, `title`, `brand`, `badges`, `category`, `breadcrumbs`, `description`, `features` |
| Item identity | `product_id`, `sku`, `gtin`, `mpn`, `model`, `specifications`, `manufacturer`, `origin`, `energy_class`, `included`, `condition`, `release_date`, `variant_group`, `variants` |
| Asking price and promotion | `price`, `was_price`, `unit_price`, `currency`, `price_text`, `discount_pct`, `discount_text`, `promo_text`, `installment_text` |
| Availability and demand | `stock_status`, `stock_text`, `sales_text`, `buy_limit` |
| Rating and seller | `rating`, `review_count`, `seller`, `seller_url`, `seller_score` |
| Fulfillment | `shipping_text`, `shipping_cost`, `delivery_text`, `pickup_text`, `return_text`, `return_days`, `warranty_text` |
| Marketplace context | `platform`, `site`, `country`, `product_url`, `source_url`, `query`, `rank`, `sponsored` |
| Processing context | `processor`, `processed_at` |

This abbreviated illustrative record uses the shared pump scenario:

```json
{
  "title": "Grundfos UPS3 15-50/65 Circulation Pump",
  "condition": "new",
  "price": 129.95,
  "currency": "GBP",
  "price_text": "£129.95",
  "shipping_text": "Postage details shown on listing",
  "seller": "example-tools-seller",
  "platform": "ebay",
  "site": "www.ebay.co.uk",
  "country": "GB",
  "product_url": "https://www.ebay.co.uk/itm/EXAMPLE",
  "source_url": "https://www.ebay.co.uk/sch/i.html?_nkw=Grundfos+UPS3+circulation+pump",
  "query": "Grundfos UPS3 circulation pump",
  "rank": 1,
  "processor": "https://apify.com/truefetch/ebay-price-tracker",
  "processed_at": "2026-07-21T12:00:00"
}
```

The example demonstrates the contract and is not a live offer. Use `product_url` for the item page and `source_url` for the search context. Check the [live Output schema](https://apify.com/truefetch/ebay-price-tracker/output-schema?fpr=aiagentapi) before enforcing strict downstream validation.

### What inputs can I configure?

| Input | Type | Required | Accepted behavior | Example |
| --- | --- | --- | --- | --- |
| `keyword` | string | Yes | A non-empty product, model, brand, category, or search phrase | `Grundfos UPS3 circulation pump` |
| `country` | string | Yes | One exact country name from the 17-value schema enum | `United Kingdom` |
| `max_results` | integer | Yes | An active-listing ceiling from 10 through 10,000 | `10` |

All three values are required. The Actor does not insert hidden search defaults or silently redirect unsupported countries. A part number or model usually produces a more comparable listing set than a broad category, but the Actor does not perform semantic entity matching.

### What platforms and markets does eBay Price Tracker cover?

This Actor searches eBay only, across 17 country marketplaces:

| Region | Supported country marketplaces |
| --- | --- |
| North America | Canada, United States |
| Europe | Austria, Belgium, France, Germany, Ireland, Italy, Netherlands, Poland, Spain, Switzerland, United Kingdom |
| Asia-Pacific | Australia, Hong Kong, Malaysia, Singapore |

Marketplace selection controls the eBay country site used for the query. It does not guarantee that identical inventory, buying formats, conditions, currencies, shipping destinations, or rankings appear in every market. Output `country`, `site`, `currency`, and source links retain the observed marketplace context when it can be verified.

### Why use eBay Price Tracker?

| Verified capability | Practical benefit |
| --- | --- |
| One normalized schema across 17 sites | Compare active marketplace snapshots without renaming columns per country. |
| Asking price and source-form text | Analyze numeric values while retaining the listing-facing representation. |
| Condition and seller context | Separate unlike resale listings before comparison. |
| Product and search URLs | Revisit the listing and preserve how it appeared in search. |
| Rank and sponsored status | Keep result-position context separate from item identity. |

The main trade-off is that active asking prices are not transaction prices. A seller can change or end a listing, a buyer can accept a different offer, and shipping can change the effective cost. Use completed-sales research when the question is what items actually sold for.

### Who is eBay Price Tracker for?

The Actor is intended for resale analysts, marketplace researchers, developers, catalog teams, and data practitioners. Common uses include collecting active price ranges for a known model, comparing conditions, reviewing seller and shipping signals, monitoring search-position snapshots, and feeding internal sourcing or catalog tools with traceable listing records.

It is not a fit for teams that require confirmed sold prices, private seller account data, bid history, order details, automated buying, or guaranteed availability. Those needs require eBay's authenticated seller or Buy APIs, Product Research, or another service designed for transaction history.

### How can I use eBay Price Tracker through the API or MCP?

The public Actor identifier is `truefetch/ebay-price-tracker`, and the current platform ID is `H8vOGccEOT22sG1uX`. The [live API page](https://apify.com/truefetch/ebay-price-tracker/api?fpr=aiagentapi) provides generated HTTP, SDK, CLI, OpenAPI, and MCP references.

Use the synchronous Dataset endpoint for the shared pump search:

```bash
curl -X POST "https://api.apify.com/v2/acts/truefetch~ebay-price-tracker/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "Grundfos UPS3 circulation pump",
    "country": "United Kingdom",
    "max_results": 10
  }'
```

For MCP, use Apify's hosted Streamable HTTP endpoint and select only this Actor when supported:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=truefetch/ebay-price-tracker"
    }
  }
}
```

After OAuth authorization, ask the client to run `truefetch/ebay-price-tracker` with the same input. Running Actors and reading run storage requires authentication. Follow the current [Apify MCP documentation](https://docs.apify.com/integrations/mcp) rather than deprecated SSE examples.

### How much does eBay Price Tracker cost?

Billing uses one start event per run and one result event for every listing record stored in the default Dataset.

| Apify tier | Actor start | Price per stored result |
| --- | ---: | ---: |
| FREE | $0.01000 | $0.00790 |
| BRONZE | $0.01000 | $0.00764 |
| SILVER | $0.01000 | $0.00737 |
| GOLD | $0.01000 | $0.00711 |
| PLATINUM | $0.01000 | $0.00711 |
| DIAMOND | $0.01000 | $0.00711 |

A FREE-tier run storing 10 listings has an Actor event charge of $0.01000 + (10 × $0.00790) = **$0.08900**. Fewer stored records create fewer result events. Separate Apify platform usage may apply. Verify the [live pricing](https://apify.com/truefetch/ebay-price-tracker/pricing?fpr=aiagentapi) before planning large or frequent searches.

### How does eBay Price Tracker compare with alternatives?

| Option | Best fit | Important trade-off |
| --- | --- | --- |
| eBay Price Tracker | Current active listings across 17 country sites in one normalized Dataset | Asking prices only; no completed-sales history |
| Product Price Tracker | Comparing eBay with compatible retail and marketplace sources | Broader runs can produce more heterogeneous records |
| eBay Browse API | Authorized application search with official item resources and filters | Requires an eBay application access token and separate integration |
| eBay Product Research | Historical sold-price and marketplace trend questions | Different account surface and research workflow |

Choose this Actor for traceable active-listing snapshots. Choose Product Research when actual sold outcomes matter, and choose the official Browse API when an authenticated eBay application integration is the requirement.

### What are the limits and troubleshooting steps?

| Symptom or limit | Explanation and next step |
| --- | --- |
| No listings are stored | Confirm the exact country name and retry a recognizable model with `max_results: 10`. |
| Fewer records than requested | The limit is a ceiling; listings can be removed, ended, or unavailable. |
| Prices vary widely | Compare condition, buying format, seller, shipping, and included items before drawing conclusions. |
| A listing URL stops working | Active listings can end or be removed after the snapshot. |
| Optional seller or shipping fields are empty | The public listing may not expose a reliable value; check the source link. |
| Apparently duplicated products appear | Multiple sellers and conditions can represent distinct listings for the same model. |
| Cost is unexpected | Count stored Dataset items and multiply by the result-event price. |

For a reproducible issue, provide one query, one country, `max_results: 10`, the run ID, and the expected versus observed result. Never include tokens, account credentials, or private order information.

### Frequently asked questions

#### Does eBay Price Tracker return sold prices?

No. It returns active listing asking prices. Sold and completed listing analysis is a separate research problem.

#### Can it search several eBay countries in one run?

No. `country` is one required string. Run a separate snapshot for each marketplace you want to compare.

#### Why is condition important for comparison?

New, used, refurbished, open-box, and unknown-condition listings are not directly equivalent. Use the normalized `condition` field when available.

#### Does `price` include shipping?

Not necessarily. `price` represents the structured listing price. Review `shipping_text` and `shipping_cost` separately when present.

#### Can an active listing disappear later?

Yes. A seller may end it, an item may sell, or eBay may remove it. Treat every Dataset as a dated snapshot.

#### Do I need an eBay developer token?

No eBay credential is a public input. Apify authentication is still required for API or MCP execution.

#### Can I schedule recurring listing checks?

Yes. Apify scheduling can repeat runs, but this Actor does not calculate deltas or send alerts itself.

#### How is billing counted?

Each stored listing item triggers one `result` event, regardless of how many optional fields are populated.

### Related TrueFetch Actors

- [Product Price Tracker](https://apify.com/truefetch/product-price-tracker?fpr=aiagentapi) adds compatible retail sources when eBay-only research is too narrow.
- [Amazon Price Tracker](https://apify.com/truefetch/amazon-price-tracker?fpr=aiagentapi) focuses on fixed storefront product searches across 22 Amazon country sites.
- [Walmart Price Tracker](https://apify.com/truefetch/walmart-price-tracker?fpr=aiagentapi) focuses on Walmart retail and marketplace records with source-linked pricing context.

### Support and last updated

Use the [Store page](https://apify.com/truefetch/ebay-price-tracker?fpr=aiagentapi), [API page](https://apify.com/truefetch/ebay-price-tracker/api?fpr=aiagentapi), and [Issues tab](https://apify.com/truefetch/ebay-price-tracker/issues/open?fpr=aiagentapi) for Actor-specific work. Community help is available in the [TrueFetch group](https://t.me/TrueFetch), and direct support is available through [AiAgentApi](https://t.me/AiAgentApi).

Last verified: **2026-07-21**. Local schemas and read-only runtime evidence control capability claims; public Store statistics and indexed snippets are treated as dated publishing evidence when they lag behind this project.

[**Start the minimum valid eBay search**](https://apify.com/truefetch/ebay-price-tracker?fpr=aiagentapi) · [**Open the generated API reference**](https://apify.com/truefetch/ebay-price-tracker/api?fpr=aiagentapi)

# Actor input Schema

## `keyword` (type: `string`):

Product name, brand, category, or search phrase to search for on eBay.

## `country` (type: `string`):

eBay country marketplace to search.

## `max_results` (type: `integer`):

Maximum number of active eBay listing records to return.

## Actor input object example

```json
{
  "keyword": "industrial pump",
  "country": "United States",
  "max_results": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Product records returned by this actor with normalized fields and source URLs.

# 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 = {
    "keyword": "industrial pump",
    "country": "United States",
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("truefetch/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 = {
    "keyword": "industrial pump",
    "country": "United States",
    "max_results": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("truefetch/ebay-price-tracker").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 '{
  "keyword": "industrial pump",
  "country": "United States",
  "max_results": 10
}' |
apify call truefetch/ebay-price-tracker --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/H8vOGccEOT22sG1uX/builds/0SKTiSkW3zVUIgDbt/openapi.json