# eBay Sold Listings Comps AI: Price Checker & Max Buy Price (`rich_minds/ebay-sold-comps-ai`) Actor

First 25 comps free. eBay sold listings cleaned into exact-match comps: for-parts, lots, accessories and outliers removed, AI-matched to your item, plus the median and max buy price. Pay per clean comp, junk never charged. Free demo on any plan; live search runs on your own Apify account.

- **URL**: https://apify.com/rich\_minds/ebay-sold-comps-ai.md
- **Developed by:** [Rich Minds](https://apify.com/rich_minds) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 clean comp (rules only)s

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

## eBay Sold Listings Comps AI: Price Checker & Max Buy Price

**Clean eBay sold comps and a max buy price for your exact item, every week.**

⚡ First **25 comps free** · 💵 **$0.005** per clean comp · 🤖 **$0.01** with the AI match check · ⏱️ demo in seconds

![One row per clean eBay sold comp — price, condition, sale date, % vs the condition median and the match score](https://api.apify.com/v2/key-value-stores/kS9lkGciS9ynBvgv6/records/shortlist.svg)

> **Try it in 30 seconds.** Click **Try it** — the form is pre-filled with 16 sample sold listings of a Nintendo Switch
> OLED. Your first **25 clean comps** are free, and junk sales are never charged.
> → [What a run costs](#-pricing--what-a-run-really-costs) · [What the AI adds](#-what-the-ai-tier-adds) · [Run it weekly](#-run-it-weekly)

### ⚡ At a glance

| | |
|---|---|
| **What you get** | eBay sold comps that match your exact item + a price report: median, band, sales per day, trend, list and max buy price |
| **You provide** | the item as a keyword, e.g. `iphone 13 pro 128gb` (1–6 per run) |
| **Typical run** | 100 sold rows → ≈ 56 clean comps, ≈ 2 min (estimate — the demo keeps 9 of 16) |
| **Cost of that run** | **$0.68 rules only** ($0.40 source + 56 × $0.005) · **$0.95 with the AI check** (42 AI-checked × $0.01, ≈ $0.06 tokens) |
| **Keys / setup** | No API key where your Apify plan includes model access — otherwise your own Gemini / Groq key (`llmProvider: byok`) |
| **Free tier** | first 25 clean comps per account |
| **Works with** | Schedules, e-mail digest, webhooks, Google Sheets, Slack, Make / n8n / Zapier, MCP & AI agents |

### 🎯 What this Actor does

It runs **eBay Sold Listings Search** (`caffein.dev/ebay-sold-listings`) on your account, drops every sale that would
skew your comps and prices the cleaned rest — resale price research without the spreadsheet:

- **Junk out before the math** — "for parts", "box only", cases and other accessories, "lot of 3", replicas: removed
  in 5 languages across the 8 eBay sites, never charged.
- **Your exact item, not its cousin** — the 13 Pro Max stays out of 13 Pro comps, 256 GB out of 128 GB, a PSA 9 out of
  PSA 10 card comps; the AI checks borderline sales against your own words.
- **Honest prices** — Best-Offer rows carry eBay's *asking* price, so they stay out of the median; so do price
  ranges, other currencies and outliers.
- **Only new sales on re-runs** — cross-run memory; the report still uses every clean sale.

#### 📉 The price report — eBay comps summed up per keyword

`PRICE_REPORT` — free with 10+ comps of the keyword in the run, else $0.03 per report; the demo run's record, whole:

```json
{"generatedAt": "2026-09-27T08:00:00+00:00", "demo": true, "reports": [
 {"keyword": "nintendo switch oled", "stats": {"n": 8, "median": 232.0}, "byCondition": {"used": {"median": 219.0}},
  "byGrade": null, "salesPerDay": 0.3, "trendPct": 4.3, "suggestedListPrice": 224.0, "maxBuyPrice": 194.32,
  "confidence": "C", "chargedEvent": null}]}
```

`maxBuyPrice` = list price × (1 − `feeRatePct`) − `shippingCost` − `targetProfit`, in the site's currency
(`resaleMath.currency`) — your bid limit. Graded cards get `byGrade`: PSA 10, PSA 9 and raw never share a median.

### 🚀 How to use it

1. **Click `Try it`** — the form runs the free demo on 16 sample sold listings; it works as is.
2. **Type your item into `keywords`** (e.g. `iphone 13 pro 128gb`) — that switches the source to the live eBay search
   on your account. Describe it in `itemDescription`, leave `enableAi` on: your first 25 comps show the AI check free.
3. **Press Start** — best matches first; the status says the median.
4. **Schedule it weekly** (Actions → Schedule) with your address in `notifyEmail` — only new sales are charged.

![The comps sheet — unit price, Buy It Now vs auction, Best-Offer asking prices, condition median, cheap-sale flag, defects](https://api.apify.com/v2/key-value-stores/kS9lkGciS9ynBvgv6/records/comps-sheet.svg)

📚 **Learn more:** [Step-by-step tutorial — ebay sold comps without the junk](https://api.apify.com/v2/key-value-stores/kS9lkGciS9ynBvgv6/records/tutorial.html)

### 🆚 Why this instead of an eBay Sold Listings Scraper?

| | [eBay Sold Listings Search (`caffein.dev/ebay-sold-listings`)](https://apify.com/caffein.dev/ebay-sold-listings) | **This Actor** |
|---|---|---|
| **Price** | $0.004 per row + $0.00005 start · 729 users / 30 days | $0.005 per clean comp ($0.01 AI-checked), first 25 free |
| **What you pay for** | every sold row, parts and lots included | clean comps only — junk and repeats cost **$0** |
| **Same 100 comps, all in** | $0.72 for ≈ 180 unsorted rows + your spreadsheet hour | 100 matched comps + report: **$0.50 here + $0.72 source you pay either way = $1.22 rules only** · ≈ $1.71 with the AI check · junk costs $0 |
| **Statistics** | none; Best-Offer asking prices count as sales | median, band, trend, list and max buy price |

**The direct eBay comps rivals** (Store, 2026-09-27) — 100 *clean* comps, like for like (≈ 180 raw rows):

| Actor | Users / 30 d | Fail | Pricing | 100 clean comps, all in |
|---|---|---|---|---|
| **This Actor** (eBay Sold Listings Comps AI) | new | 0 % | $0.005 / clean comp, $0.01 AI-checked, 25 free | **$1.22** rules · **$1.71** AI (source included) |
| `midwest_united/ebay-sold-comps` | 3 | 6.5 % | $0.02 / comp + $0.10 / report | $2.10 |
| `marielise.dev/ebay-sold-listings-intelligence` | 13 | 2.0 % | $0.025 per row | $2.50 |
| `xtracto/ebay-sold-comps-scraper` | 5 | 5.1 % | $0.03 per row + $0.005 start | $3.01 |
| `khadinakbar/ebay-sold-comps-analytics-scraper` | 3 | 8.7 % | $0.005 / raw item + $0.05 / report | $0.95 for 180 raw rows + your cleanup |
| `memo23/ebay-search-scraper-ppe` | 221 | 2.0 % | $0.005 / raw row + $0.02 summary + $0.02 start | $0.94 for 180 raw rows + your cleanup |

#### 💸 A Terapeak alternative and a ZIK Analytics alternative

| Tool | Cost | Lacks | Where it wins |
|---|---|---|---|
| Terapeak (eBay Seller Hub) | free | API, schedule, alerts, lot / variant cleanup, max buy price — one manual search at a time | 3 years of eBay data, active-listing counts |
| 130point | free | the same, and no median | accepted Best-Offer prices (cards) — eBay's sold data shows the asking price |
| ZIK Analytics PRO | **$39.9 / month** ([pricing](https://www.zikanalytics.com/pricing), checked 2026-09-27) | a seat, manual lookups | product research beyond comps |

A weekly 5-item watchlist here: ≈ **$7 / month rules only**, ≈ **$10 with the AI check**.

### 💵 Pricing — what a run really costs

| Event | When it is charged | Price |
|---|---|---|
| `free-tier` | your first 25 clean comps, any mode | **$0.00** |
| `qualified-comp-basic` | a clean comp scored by the rules (AI off, or a clear match the AI skipped) | **$0.005** |
| `qualified-comp-ai` | a clean comp the AI checked: verdict, attributes, defects | **$0.01** |
| `price-report` | a keyword's `PRICE_REPORT` when fewer than 10 of its comps are delivered in the run (free with 10+) | **$0.03** |

**One free tier:** when the AI is unavailable, rule-scored comps use your 25 free comps too, except the last 5, kept
so you still see the AI tier free.

**Never charged:** rejected rows (counted per reason in `OUTPUT.rejected`), sales you already received, the demo, the
digest. Platform compute is included.

**How that compares** — 1.33× the $0.00375 median of the Store's "ebay sold listings" Actors, which bill raw rows;
one clean comp replaces 1.8 raw rows ($0.0068) plus the cleanup. Comps rivals charge $0.02–0.03: 4–6× more.

**Worked example** — 1 keyword × 100 sold rows: **$0.40** source on your account → 56 clean comps. AI off: 56 × $0.005 →
**$0.68** (≈ $0.012 for each clean comp). AI on: 42 used / borderline comps × $0.01 + 14 × $0.005 + ≈ $0.06 tokens →
**$0.95** (≈ $0.017 each). Your first 25 comps are free.

**AI tier, all in:** ≈ **$0.0114 per AI-checked comp** ($0.01 + ≈ $0.0014 tokens, estimate) — 2.3× the basic comp.

### 🤖 What the AI tier adds

The AI reads item specifics and the seller's text against *your* item. The same comp, AI **off** (the demo run):

```json
{"title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great", "unitPrice": 211.5, "score": 95,
 "attributes": {"model": null, "storage": null, "color": null}, "aiAssessment": {"verdict": null}}
```

AI **on** (`qualified-comp-ai`) — the AI example run on 2026-09-27 with an own Groq key, checked
against "Nintendo Switch OLED console with dock and Joy-Cons, working, any colour":

```json
{"title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great", "unitPrice": 211.5, "score": 85,
 "attributes": {"brand": "Nintendo", "model": "Switch OLED", "storage": "64GB", "color": "Neon Red/Blue"},
 "aiAssessment": {"verdict": "exact", "confidence": 0.85, "severity": "none", "model": "groq:openai/gpt-oss-120b",
                  "reason": "Title matches Nintendo Switch OLED 64GB Neon Red/Blue, the same console model and storage."}}
```

With Apify's model access it runs on `anthropic/claude-haiku-4.5`; without it, the demo shows these verdicts labelled
`aiModel: "sample"`, never charged. It saves opening each borderline listing (20–30 s each).

### ⚙️ Input

| Field | Default | What it does |
|---|---|---|
| `keywords` | — | 1–6 eBay searches, one report each; typing one starts the live search |
| `sourceMode` | `actor` | live search · `dataset` · `list`. With nothing to search — `{}` over the API — the free demo runs: nothing charged, the source Actor is never started |
| `minScore` | `70` | The match a comp needs — the field that decides what you pay |
| `itemDescription` | — | Your exact item in words, for the AI check |
| `maxQualified` | `200` | Cap on comps delivered and charged; the report uses all (under 10 comps: $0.03 per report) |
| `maxDiscoveryChargeUsd` | `0.5` | Caps the eBay search's cost ($0.004 per row) |
| `enableAi` | `true` | AI match check on borderline / used comps |
| `mustInclude` / `mustExclude` | — | Title terms, number-aware (`128gb` = "128 GB") |
| `keepConditions` | `new, open_box, refurbished, used` | Conditions that count |
| `lotHandling` / `bestOfferHandling` | `exclude` / `excludeFromStats` | Lots: exclude · normalize · include; Best Offer: out of stats · include · drop |
| `ebaySite` / `daysToScrape` / `maxSoldPerKeyword` | `ebay.com` / `30` / `100` | Where and how far back |
| `feeRatePct` / `shippingCost` / `targetProfit` | `13.25` / `0` / `0` | The max-buy-price math, in the site's currency (the 0.1 names `shippingCostUsd` / `targetProfitUsd` still work) |
| `alertOnly` / `alertMedianMovePct` | `false` / `10` | E-mail / Slack / Discord only on a sale under your max buy price or a median move |

The rest — `outlierIqrK`, `categoryId`, `minPrice` / `maxPrice`, `targetFlags`, `suppressionList`, the model,
`webhookHeaders`, `dedupeStoreName` (one per client) — is in the **Input** tab.

#### Flags

Names for `targetFlags` (`belowP25` works too) — only comps with one are delivered; an unknown name stops the run.

<details><summary>All flags</summary>

| Flag (`targetFlags` value) | Meaning |
|---|---|
| `below_p25` | sold below the 25th percentile of its condition — a cheap sale |
| `price_is_asking` | Best Offer accepted — the price is the asking price |
| `auction` / `buy_it_now` | how it sold |
| `free_shipping` | shipped free |
| `lot_normalized` | a lot; `unitPrice` = total ÷ lot size |
| `has_defects` | defects named in the title or the seller's text |
| `read_description` | the title says "read description" |
| `variant_risk` | the title names a variant or card grade your keyword does not |
| `low_feedback_seller` | under 98 % positive or under 10 ratings |

</details>

### 📤 Output

One dataset item per new clean comp — the demo row from above:

```json
{"itemId": "300000000010", "url": "https://www.ebay.com/itm/300000000010", "keyword": "nintendo switch oled",
 "title": "Nintendo Switch OLED Console Neon - minor scratches on screen", "conditionBucket": "used",
 "endedAt": "2026-09-16", "unitPrice": 199.0, "currency": "USD", "matchVerdict": "exact",
 "bucketMedian": 219.0, "priceVsMedianPct": -9.1, "isBelowP25": true, "score": 95, "label": "hot",
 "suggestedPriceNote": "Sold 199.00 USD on 2026-09-16 (used) — 9.1 % below the 219.00 USD used median.",
 "chargedEvent": "demo", "dedupeKey": "ebay:ebay.com:300000000010"}
```

<details><summary>Every field of a row</summary>

| Field | Description |
|---|---|
| `itemId`, `url`, `title`, `keyword`, `ebaySite` | The sold listing and the search that found it |
| `categoryId`, `category`, `condition`, `conditionId`, `conditionBucket` | eBay's category and condition, bucketed new / open\_box / refurbished / used / parts / unknown |
| `grade` | A card's grade from the title — `PSA 10`, `BGS 9.5`, `CGC 9.8`, `raw` — null when none is named |
| `endedAt`, `soldPrice`, `shippingPrice`, `shippingType`, `totalPrice`, `currency` | The sale, prices parsed from the source's strings |
| `lotSize`, `unitPrice` | Units sold together; `unitPrice` = total ÷ lot size — what the statistics use |
| `listingType`, `buyingFormat`, `bidCount`, `priceIsAsking`, `quantitySold` | How it sold; `priceIsAsking` = Best Offer accepted |
| `imageUrl`, `sellerUsername`, `sellerFeedbackScore`, `sellerPositivePercent`, `sellerType` | Photo and the public seller card |
| `matchVerdict`, `matchReasons`, `ruleScore`, `fitScore` | The verdict and why, the rule score, the AI's score |
| `attributes`, `defects`, `aiAssessment`, `aiModel` | AI: brand / model / storage / size / color / edition / carrier / region, defects, verdict (keys null without AI) |
| `bucketMedian`, `priceVsMedianPct`, `isBelowP25`, `suggestedPriceNote` | The sale against its condition's median |
| `flags`, `targetFlagsMatched`, `score`, `label` | Flags; `score` = the match score (AI's when assessed, else the rules') |
| `chargedEvent`, `billedAs`, `dedupeKey`, `firstSeenAt`, `source`, `scrapedAt` | Billing and provenance (`billedAs` = the price tier, also on free rows) |

</details>

**Upsert key:** `dedupeKey` — `ebay:<site>:<itemId>`, the key of the cross-run memory; `itemId` is eBay's item number.

Views: `Shortlist`, `Comps sheet (CSV)`, `AI match check`. Next to `OUTPUT`: `PRICE_REPORT` (`generatedAt`, `demo`,
`reports` — one per keyword), a **`DIGEST`** (what changed since the last run — `OUTPUT.trend`) and a client-ready
**`REPORT`** page. Outcomes: [Run outcomes](#run-outcomes--what-your-integration-sees); AI-on runs say "N AI-assessed
(model; D delivered, R rejected), M rule-scored (reasons)" — `OUTPUT.aiCoverage`, the reasons add up.

⭐ **Found it useful? A review on the Store helps others find it** — it takes a minute on the Actor's page.

### 🔁 Run it weekly

1. **Actions → Save as a new task → Schedule** after a real run (input: `OUTPUT.scheduleInput`), with `notifyEmail` —
   every run mails the median per keyword **and its change vs the last run**, then the new comps.
2. Keep `dedupeAcrossRuns: true` — the next run charges **only new sales**; the report still uses every clean one.
   Each run adds to the **price history** of the search: `OUTPUT.history`, a median-per-run chart on the `REPORT` page
   and a sparkline in the digest.
3. `slackWebhookUrl` / `discordWebhookUrl` post the same digest. **Deal alerts:** `alertOnly: true` posts only when a
   new sale lands under your max buy price or a median moves ≥ `alertMedianMovePct` (10 %) — `OUTPUT.alerts`.
4. Into a sheet: import the [n8n workflow](docs/img/n8n-weekly-comps.json) (Monday → run → Google Sheet upsert on
   `dedupeKey` → Slack) and the [Sheets template](https://api.apify.com/v2/key-value-stores/kS9lkGciS9ynBvgv6/records/sheets-comps-template.csv); or `webhookUrl` per comp.

Weekly cost of 5 items (`daysToScrape: 7`, `maxSoldPerKeyword: 50`, `maxDiscoveryChargeUsd: 1`): $1.00 source → ≈ 135
new comps = $0.68 → **≈ $1.68 / week rules only**, ≈ $2.32 with the AI check (estimates).

#### 🎯 Try it for your niche

| Niche | What it looks for | Input |
|---|---|---|
| Console flipper | three consoles, lots normalized, shipping + profit | [preset-console-flipper.json](docs/img/preset-console-flipper.json) |
| Phone reseller | exact storage, no Max / Mini / Plus | [preset-phone-reseller.json](docs/img/preset-phone-reseller.json) |
| Card collector | one graded card, 90 days, deal alerts | [preset-card-collector.json](docs/img/preset-card-collector.json) |

Paste one into the Input tab's JSON view, add `notifyEmail`, press Start.

### 🔌 Integrations, automation and API

- **Webhook** — each new comp, then one `comps.report` per keyword (payloads below); a failed POST never fails the run.
- **Google Sheets / Slack** — the Integrations tab. **Discord** — `discordWebhookUrl`, or a `/comps <item>` bot for
  your group ([recipe](docs/marketing/kit/integrations.md#discord-comps-bot)).
- **AI agents / MCP** — plain typed fields. **First call = the free trial:** `{}` runs the free demo.

<details><summary>Webhook payloads, Python and JavaScript — copy-paste, with the timeout and a build pin</summary>

Webhook: `{"event": "comp.qualified", "comp": {…}, "runId": "…"}`; with `webhookBatchSize` > 1
`{"event": "comps.qualified", "comps": [{…}, …], "runId": "…"}` (the last batch may be shorter). A 429 / 5xx / network
error is retried once after 2 s (15 s timeout); a failed POST is counted in `OUTPUT.webhook.failed`.

**Minimal agent input:** `{"keywords": ["iphone 13 pro 128gb"], "itemDescription": "iPhone 13 Pro 128GB unlocked", "targetProfit": 60, "maxDiscoveryChargeUsd": 0.5}`;
`{"sourceMode": "list", "itemsList": [...]}` cleans the rows you send, free inside your 25 comps.

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("rich_minds/ebay-sold-comps-ai").call(
    run_input={"keywords": ["iphone 13 pro 128gb"], "itemDescription": "iPhone 13 Pro 128GB unlocked",
               "maxDiscoveryChargeUsd": 0.5},  # hard cap on the eBay search's cost on your account
    timeout_secs=3600,  # the run's own timeout — see "How long does a run take?"
    # build="0.2",  # pin the build your pipeline was tested with (Changelog below)
)
report = client.key_value_store(run["defaultKeyValueStoreId"]).get_record("PRICE_REPORT")["value"]
print([(r["keyword"], r["stats"]["median"], r["maxBuyPrice"]) for r in report["reports"]])
```

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

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('rich_minds/ebay-sold-comps-ai').call({
    sourceMode: 'list', // free trial: clean the rows you send
    itemsList: [{ itemId: '1', title: 'Nintendo Switch OLED White', soldPrice: '219.00', condition: 'Pre-Owned' }],
    maxDiscoveryChargeUsd: 0.5, // spend cap once you send keywords
}, { timeout: 3600 /* , build: '0.2' — pin the build your pipeline was tested with */ });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((i) => [i.title, i.unitPrice, i.score]));
```

</details>

**Use it from Claude, ChatGPT or any MCP client:**

```json
{"mcpServers": {"apify": {"url": "https://mcp.apify.com/?actors=rich_minds/ebay-sold-comps-ai"}}}
```

Then ask: *"Run ebay-sold-comps-ai with no input (free demo), then price `iphone 13 pro 128gb` with
`maxDiscoveryChargeUsd: 0.5` — median and max buy price?"*

#### List-mode rows — what a pasted record needs

`list` and `dataset` mode run on any plan, with rows of any eBay sold scraper.

<details><summary>Fields a row can carry and what each switches on</summary>

| Field | Needed? | What it enables |
|---|---|---|
| `title` (or `name`) | required | matching, junk / lot / variant checks |
| `soldPrice` (or `price`, string or number) | required | every price field and the report |
| `itemId` (or `id`), `url` (or `link`) | optional | the link and the `dedupeKey` |
| `keyword` | optional | the report group (else your first keyword) |
| `condition`, `conditionId` | optional | `conditionBucket`, per-condition medians |
| `endedAt` (or `soldDate`) | optional | trend, sale date |
| `shippingPrice`, `totalPrice`, `soldCurrency` | optional | `totalPrice`, `unitPrice`, one currency per report |
| `isBestOfferAccepted`, `listingType`, `buyingFormat`, `bidCount` | optional | `priceIsAsking`, auction vs Buy It Now |
| `soldPriceMax` | optional | a variant price range → rejected |
| `itemSpecifics`, `productDetails`, `sellerDescriptionText` | optional | AI attributes and defects |
| `thumbnailUrl`, `sellerUsername`, `sellerFeedbackScore`, `sellerPositivePercent`, `quantitySold`, `categoryId`, `category`, `shippingType`, `sellerType`, `scrapedAt` | optional | the same output fields |

</details>

#### Run outcomes — what your integration sees

<details><summary>Every outcome: run status, dataset, <code>OUTPUT</code> field, charged?, what to do</summary>

| Outcome | Run status | Dataset | `OUTPUT` | Charged? | What to do |
|---|---|---|---|---|---|
| Free demo (the pre-filled sample) | SUCCEEDED | sample comps (AI on: sample AI verdicts, `aiModel: sample`) | `qualified`, `priceReports` | no | type your own keywords |
| Success | SUCCEEDED | new clean comps, best match first | funnel, `rejected`, `priceReports`, `aiCoverage` | per clean comp | — |
| Nothing new (all seen before) | SUCCEEDED | empty | `qualified: 0`, `priceReports`, `reportsCharged` | $0.03 per report (under 10 comps) | — the report still updates |
| Nothing matched | SUCCEEDED | empty | `qualified: 0`, `rejected` | no | loosen `minScore` / filters |
| Demo text still in place | SUCCEEDED | empty | `inputNeeded` | no | replace the field the status names |
| Invalid input | FAILED | empty | — | no | fix the field the status names |
| Source failed | FAILED | empty | `sourceError` | no | follow the reason; any plan: paste [list-mode rows](#list-mode-rows--what-a-pasted-record-needs) |
| Source partial (the eBay search timed out / was aborted after scraping) | SUCCEEDED | clean comps from the rows scraped | `sourceStatus` (`status`, `partial: true`) | per clean comp | raise `discoveryTimeoutSecs` or lower `maxSoldPerKeyword` |
| AI unavailable | SUCCEEDED | rule-scored comps | `aiError`, `freeAiReserve` | free while your free comps last (5 kept for the AI), then basic | `llmProvider: byok` with your own key |

</details>

### 👥 Who is it for?

| You are… | You run it to… | Start with |
|---|---|---|
| A reseller / flipper | know what *this exact item* sells for and the most you can pay | `keywords` + `targetProfit`, `shippingCost` |
| An eBay seller pricing inventory | list at the price that sells in your condition | `keywords` + `keepConditions: ["used"]` |
| A consignment shop / agency | a price band per client item, one memory per client | `keywords` + `dedupeStoreName` + the `REPORT` link |
| A collectibles buyer | a weekly watchlist that pings on a deal | `daysToScrape: 90` + `alertOnly` + `notifyEmail` |

### 🧠 How the AI works

- **Grounded, not generative.** One listing → a typed verdict (exact / variant / accessory / parts / lot / unrelated),
  confidence, attributes, defects — each a substring of the listing, else dropped. The model never writes a price.
- **Tokens only where they matter:** borderline sales (rule score 40–90) and used / open-box matches, best first.
- **Model:** `anthropic/claude-haiku-4.5` via Apify's model access, or `llmProvider: "byok"`. **Fallback:** a model
  error keeps the rule score, verdict and defect lexicon.

### 🔒 Data, compliance and limits

- Public sold listings only, fetched on your account; no login; not affiliated with eBay. 8 sites, 1–6 keywords, up to
  90 days, one currency per report. Keep your use within eBay's terms and GDPR / CCPA.

### ❓ FAQ

**What will my first real search cost?** At most $0.50 on the eBay search (1 keyword × 100 rows = $0.40), then ≈ 56
clean comps — 25 free, the rest $0.005 ($0.01 AI-checked).

**Is this an eBay sold listings search or an eBay sold listings scraper?** Both: it runs eBay Sold Listings Search on
your account and adds the cleanup, the match check and the price report; rows of any eBay sold listings scraper work in
`dataset` / `list` mode.

**What is the eBay sold price of my item — is this an eBay price checker?** Yes: the status and `PRICE_REPORT` give the
median per condition, the list price and the max buy price, built on clean comps only.

**Are these eBay sold comps good reseller comps for flipping?** Yes — only exact matches, per condition, with
sell-through and trend; set `targetProfit` and the max buy price is your bid limit.

**Why pay when Terapeak or 130point is free — and how is this different from ZIK Analytics?** Terapeak and 130point
are free, manual, one search at a time — no API, schedule, alerts, lot / variant cleanup or max buy price; 130point
wins on accepted Best-Offer prices, which eBay's sold data (and this Actor) cannot see. ZIK Analytics PRO is $39.9 /
month; a weekly 5-item watchlist here is ≈ $7 / month rules only, in your own sheet.

**How long does a run take?** Demo: 0.1 s for 16 rows (measured, `OUTPUT.timing`). Live: the source run (≈ 1–2 min per
100 rows) + ≈ 1 s per AI-checked comp with Apify's model access (estimates). Own key (`llmProvider: byok`): 2 calls at
a time, one after a rate limit, AI stops after 2 min of waiting (`OUTPUT.timing.aiBackoffSecs`); a free-tier key
checked 2 of 9 comps in 103 s (measured) — expect 1–3 AI checks per run, a second pass retries the borderline comps
one at a time; a paid Groq / Gemini key checks every comp. Worst case with a slow own key: ≈ 25 min per 100 borderline
comps, stopped before the run's own timeout (3600 s) — pass `timeoutSecs` 3600 to `.call()`.

**Which Apify plan do I need?** Any plan runs the demo and `dataset` / `list` mode; the live search runs a Store Actor
and the built-in AI uses Apify's model access — without them, use `list` mode and your own key.

### 🧩 More Actors from the same developer

Not quite your use case? The same pay-per-qualified-result model, for the same e-commerce buyers:

- **[Facebook Ad Library Winning Ads Finder](https://apify.com/rich_minds/fb-ad-library-winning-ads)** — the products whose Facebook ads are winning right now, before you source one

### 🆘 Support

Something missing or wrong? Open an issue on the Actor's page or message the developer through the Apify Console —
requests from buyers are shipped first.

### 📝 Changelog

One line per published build, newest first. Next: a deal finder (live listings under your max buy price), a batched
AI check, bulk SKUs.

- **0.3.2** (2026-09-27) — 2026-09-26.md — M-01.
- **0.3.1** (2026-09-27) — card grades (`grade`, `byGrade`); price history; Discord digest; `price-report` $0.03 under
  10 comps; an AI second pass for rate-limited own keys.
- **0.2.1** (2026-09-27) — deal alerts (`alertOnly`); sample AI verdicts on every plan; `shippingCost` /
  `targetProfit`; `matchScore` dropped, use `score`; `OUTPUT.sourceStatus`.
- **0.1.1** (2026-09-26) — first public release — clean eBay sold comps, the free price report and the AI match check.

# Actor input Schema

## `keywords` (type: `array`):

The item you price, one keyword per line, e.g. <code>nintendo switch oled</code> or <code>iphone 13 pro 128gb</code> — one price report each. The live search runs eBay Sold Listings Search on your Apify plan (no Store Actors on your plan? use a dataset). The free demo does not search it; typing a keyword starts the live search.

## `sourceMode` (type: `string`):

<b>Search eBay live</b> for the keywords above (rows billed by eBay Sold Listings Search, capped by <b>Max source spend</b>), clean an existing <b>dataset</b>, or paste a <b>list</b> of sold rows. With nothing to search (<code>{}</code>) the free demo runs on 16 sample sold listings — nothing charged.

## `minScore` (type: `integer`):

The field that decides what you pay: sales whose match to your item scores below this are rejected and <b>not charged</b>. 70 keeps exact matches; raise it to 85 for only sure ones. Rules cap at 95; 96–100 needs the AI's exact verdict.

## `itemDescription` (type: `string`):

Describe the exact item — model, storage, colour, condition — e.g. <i>iPhone 13 Pro Max 128GB unlocked, working</i>. The AI match check compares every borderline sale with it. Leave empty to match on the keywords only.

## `maxQualified` (type: `integer`):

Hard cap on the comps pushed and on what <b>this Actor</b> charges: at most this many × $0.01 with AI on (× $0.005 off), e.g. 200 × $0.01 = $2.00. The price report always uses every clean comp. Best matches first.

## `maxDiscoveryChargeUsd` (type: `number`):

Hard cap on what the eBay search may charge your account ($0.004 per sold row, so 1 keyword × 100 rows ≈ $0.40) — $0.50 in the form and for API calls that leave it out. Raise it for more keywords.

## `enableAi` (type: `boolean`):

Checks every borderline sale against your exact item (verdict, confidence, model / storage / colour), lists the defects the listing admits and writes the report summary. <b>On = $0.01 per AI-checked comp + AI tokens; off = $0.005</b> (rule match only). Clear matches stay at the basic price.

## `notifyEmail` (type: `string`):

After every run with new comps or a price report, the digest (median, band, list and max-buy price per keyword, change vs last run, the new comps with links) is e-mailed here. Schedule the run weekly and it lands in your inbox. Never sent for the free demo.

## `mustInclude` (type: `array`):

Terms every matching title must contain, number-aware: <code>128gb</code> matches "128 GB". A sale missing one is capped at score 40 — rejected unless the AI confirms it.

## `mustExclude` (type: `array`):

A title with any of these terms is rejected, e.g. <code>max</code>, <code>mini</code>, <code>refurbished</code>.

## `keepConditions` (type: `array`):

Condition buckets that count as comps (from eBay's condition id and the local label). <b>For parts</b> and <b>unknown</b> are off by default.

## `lotHandling` (type: `string`):

"Lot of 3", "3x", "bundle", "Konvolut": <b>exclude</b> them, <b>normalize</b> (price ÷ lot size — a lot without a number is excluded) or <b>include</b> as sold.

## `bestOfferHandling` (type: `string`):

eBay shows the asking price, not the accepted offer, on these. <b>Keep out of the statistics</b> (delivered with <code>priceIsAsking: true</code>), <b>include</b> them anyway, or <b>drop</b> them.

## `outlierIqrK` (type: `number`):

Sales outside Q1 − k·IQR … Q3 + k·IQR of their keyword and condition (5+ sales) are rejected free. 1.5 is Tukey's fence; 3 keeps more; 0 turns it off.

## `targetFlags` (type: `array`):

Only deliver comps with at least one of these flags, e.g. <code>below\_p25</code> for cheap sales or <code>auction</code> (<code>belowP25</code> works too). The price report still uses every clean comp. An unknown name stops the run with the valid ones.

## `suppressionList` (type: `array`):

eBay item ids, URLs or seller usernames to never output — skipped before any processing and never charged.

## `ebaySite` (type: `string`):

The eBay site the live search runs on. One currency per report — sales in another currency are rejected free.

## `daysToScrape` (type: `integer`):

The sold window (1–90 days) — also the window of the sell-through rate (sales per day) in the report.

## `maxSoldPerKeyword` (type: `integer`):

How many sold rows the source loads per keyword (its <code>count</code>, $0.004 each on your account). 100 gives a solid median; the spend cap above still applies.

## `categoryId` (type: `string`):

Only sales in this eBay category, e.g. <code>139971</code> (video game consoles). Leave empty for all.

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

Only sales at or above this price (site currency) — the source skips the rest, so you pay for fewer junk rows.

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

Only sales at or below this price (site currency).

## `feeRatePct` (type: `number`):

Your eBay final-value-fee rate for the max-buy-price math: <code>maxBuyPrice = suggestedListPrice × (1 − fee) − shippingCost − targetProfit</code>, all in the site's currency.

## `shippingCost` (type: `number`):

What shipping one unit costs you, in the eBay site's currency (USD on ebay.com, GBP on ebay.co.uk, EUR on ebay.de …); subtracted in the max buy price. The 0.1 name <code>shippingCostUsd</code> still works.

## `targetProfit` (type: `number`):

The profit you want per unit, in the eBay site's currency; subtracted in the max buy price. The 0.1 name <code>targetProfitUsd</code> still works.

## `llmProvider` (type: `string`):

<b>Apify (no keys)</b> — the AI runs through Apify's built-in OpenRouter proxy; tokens are billed to your Apify account at OpenRouter's rates. <b>My own key</b> — use your OpenAI / Anthropic / Gemini / Groq key instead. A free-tier key is rate-limited: expect 1–3 AI checks per run (the borderline comps first, one at a time after a rate limit), the rest keep their rule score; a paid Groq / Gemini key (billing on) assesses every comp.

## `llmModel` (type: `string`):

Leave empty for the default (<code>anthropic/claude-haiku-4.5</code>). Apify mode takes an OpenRouter slug such as <code>openai/gpt-4.1-mini</code>; own-key mode takes <code>provider:model</code>, e.g. <code>anthropic:claude-haiku-4-5-20251001</code>.

## `llmApiKey` (type: `string`):

Required when <b>AI model access</b> is <i>My own API key</i>. Stored encrypted by Apify, never logged.

## `aiCandidateMultiplier` (type: `integer`):

The AI checks the borderline sales only — rule score 40–90, or a clear match in used / open-box condition (for its defects) — best rule score first, up to this multiple of <b>Max comps to deliver</b>.

## `slackWebhookUrl` (type: `string`):

A Slack incoming-webhook URL (<code>https://hooks.slack.com/services/…</code>). After every run the digest (median and change per keyword, the new comps with links) is posted to that channel as a readable message. Never sent for the free demo.

## `discordWebhookUrl` (type: `string`):

A Discord channel webhook URL (<code>https://discord.com/api/webhooks/…</code>, channel settings → Integrations → Webhooks). After every run the digest (median, list and max-buy price per keyword, the new comps with links) is posted to that channel — made for reseller groups. Stored encrypted; never sent for the free demo.

## `alertOnly` (type: `boolean`):

On a schedule: send the e-mail / Slack / Discord digest <b>only</b> when a new sale lands at or under your max buy price, or a keyword's median moved by at least <b>Median move to alert on</b> since the last run — a “buy now” ping instead of a weekly report. The comps and the price report are delivered either way.

## `alertMedianMovePct` (type: `number`):

With <b>Deal alerts only</b>: alert when a keyword's median moved by at least this many percent (up or down) vs the last run.

## `webhookUrl` (type: `string`):

New comps are POSTed here as JSON (Zapier, Make, n8n, your database), then one <code>comps.report</code> per keyword. For Google Sheets / Slack you can also use Apify's Integrations tab. Stored encrypted — hook URLs carry their secret in the path.

## `webhookHeaders` (type: `object`):

Extra HTTP headers for the webhook, e.g. <code>{"Authorization": "Bearer …"}</code>. Stored encrypted by Apify, never logged.

## `webhookBatchSize` (type: `integer`):

1 = one POST per comp the moment it is ready. Higher = one POST per N comps.

## `dedupeAcrossRuns` (type: `boolean`):

Remembers every comp you were charged for (eBay site + item id, in a key-value store on your account): a weekly run delivers only new sales, while the price report still uses every clean sale in the window.

## `dedupeStoreName` (type: `string`):

Key-value store used for cross-run memory. Left at the default, the memory is kept per search (source, keywords, eBay site): rewording <code>itemDescription</code> keeps it. Pricing for several clients on one account, type one name per client.

## `datasetId` (type: `string`):

Only for <b>dataset</b> mode: a dataset of eBay sold listings (from eBay Sold Listings Search or another eBay sold scraper — <code>price</code>, <code>soldDate</code>, <code>link</code>, <code>id</code> work too).

## `itemsList` (type: `array`):

Only for <b>list</b> mode. JSON array of sold listings with at least <code>title</code> and <code>soldPrice</code>; <code>itemId</code>, <code>url</code>, <code>condition</code>, <code>endedAt</code>, <code>keyword</code> and the other README list-mode fields switch on the rest of the output.

## `discoveryActorId` (type: `string`):

Actor used in <b>actor</b> mode. Any Actor whose output has the fields of eBay Sold Listings Search works.

## `discoveryInput` (type: `object`):

Only for <b>actor</b> mode. Extra input merged into the eBay Sold Listings Search call, e.g. <code>{"itemCondition": "used"}</code>; the fields above win. The live search runs that Store Actor on your Apify plan — if your plan cannot run Store Actors, use <b>dataset</b> mode.

## `maxToProcess` (type: `integer`):

Upper bound on the new sold rows cleaned and matched in one run (controls run time). Default = 3 × max comps.

## Actor input object example

```json
{
  "sourceMode": "list",
  "minScore": 70,
  "itemDescription": "Nintendo Switch OLED console with dock and Joy-Cons, working, any colour",
  "maxQualified": 200,
  "maxDiscoveryChargeUsd": 0.5,
  "enableAi": true,
  "keepConditions": [
    "new",
    "open_box",
    "refurbished",
    "used"
  ],
  "lotHandling": "exclude",
  "bestOfferHandling": "excludeFromStats",
  "outlierIqrK": 1.5,
  "ebaySite": "ebay.com",
  "daysToScrape": 30,
  "maxSoldPerKeyword": 100,
  "feeRatePct": 13.25,
  "shippingCost": 0,
  "targetProfit": 0,
  "llmProvider": "apify",
  "aiCandidateMultiplier": 2,
  "alertOnly": false,
  "alertMedianMovePct": 10,
  "webhookBatchSize": 1,
  "dedupeAcrossRuns": true,
  "dedupeStoreName": "ebay-sold-comps-ai-seen",
  "itemsList": [
    {
      "itemId": "300000000001",
      "url": "https://www.ebay.com/itm/300000000001",
      "title": "Nintendo Switch OLED Model White Console with Dock and Joy-Cons",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-24",
      "soldPrice": "219.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "219.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample1/s-l225.jpg",
      "sellerUsername": "retro_flips_22",
      "sellerFeedbackScore": 1200,
      "sellerPositivePercent": 99.6,
      "scrapedAt": "2026-09-27T08:00:00Z",
      "itemSpecifics": {
        "Brand": "Nintendo",
        "Model": "Nintendo Switch OLED",
        "Color": "White",
        "Storage Capacity": "64 GB"
      }
    },
    {
      "itemId": "300000000002",
      "url": "https://www.ebay.com/itm/300000000002",
      "title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-22",
      "soldPrice": "199.50",
      "soldCurrency": "USD",
      "shippingPrice": "12.00",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "211.50",
      "listingType": "auction",
      "isBestOfferAccepted": false,
      "buyingFormat": "AUCTION",
      "bidCount": 23,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample2/s-l225.jpg",
      "sellerUsername": "garage.sale.gamer",
      "sellerFeedbackScore": 341,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000003",
      "url": "https://www.ebay.com/itm/300000000003",
      "title": "NEW Nintendo Switch OLED Model White - Factory Sealed",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-25",
      "soldPrice": "309.99",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "309.99",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample3/s-l225.jpg",
      "sellerUsername": "dealsdirect_us",
      "sellerFeedbackScore": 15400,
      "sellerPositivePercent": 99.2,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000004",
      "url": "https://www.ebay.com/itm/300000000004",
      "title": "Nintendo Switch OLED Console For Parts Not Working - No Power",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "For parts or not working",
      "conditionId": 7000,
      "endedAt": "2026-09-20",
      "soldPrice": "89.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "89.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample4/s-l225.jpg",
      "sellerUsername": "fixit_fred",
      "sellerFeedbackScore": 88,
      "sellerPositivePercent": 98.9,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000005",
      "url": "https://www.ebay.com/itm/300000000005",
      "title": "Nintendo Switch OLED Box Only - Empty Box No Console",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-19",
      "soldPrice": "14.99",
      "soldCurrency": "USD",
      "shippingPrice": "4.99",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "19.98",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample5/s-l225.jpg",
      "sellerUsername": "collect_n_ship",
      "sellerFeedbackScore": 2210,
      "sellerPositivePercent": 99.9,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000006",
      "url": "https://www.ebay.com/itm/300000000006",
      "title": "Carrying Case for Nintendo Switch OLED - Hard Shell Travel Case",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-21",
      "soldPrice": "16.99",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "16.99",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample6/s-l225.jpg",
      "sellerUsername": "accessory_hub",
      "sellerFeedbackScore": 9021,
      "sellerPositivePercent": 98.7,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000007",
      "url": "https://www.ebay.com/itm/300000000007",
      "title": "Nintendo Switch Lite Turquoise Handheld Console",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-23",
      "soldPrice": "139.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "139.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample7/s-l225.jpg",
      "sellerUsername": "retro_flips_22",
      "sellerFeedbackScore": 1200,
      "sellerPositivePercent": 99.6,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000008",
      "url": "https://www.ebay.com/itm/300000000008",
      "title": "Lot of 2 Nintendo Switch OLED Consoles White + Neon",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-18",
      "soldPrice": "455.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "455.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample8/s-l225.jpg",
      "sellerUsername": "bulk_buys_llc",
      "sellerFeedbackScore": 512,
      "sellerPositivePercent": 97.4,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000009",
      "url": "https://www.ebay.com/itm/300000000009",
      "title": "Nintendo Switch OLED White 64GB with Dock - Excellent",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-26",
      "soldPrice": "240.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "240.00",
      "listingType": "best_offer_accepted",
      "isBestOfferAccepted": true,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample9/s-l225.jpg",
      "sellerUsername": "thrift_to_profit",
      "sellerFeedbackScore": 77,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000010",
      "url": "https://www.ebay.com/itm/300000000010",
      "title": "Nintendo Switch OLED Console Neon - minor scratches on screen",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-16",
      "soldPrice": "185.00",
      "soldCurrency": "USD",
      "shippingPrice": "14.00",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "199.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample10/s-l225.jpg",
      "sellerUsername": "weekend.reseller",
      "sellerFeedbackScore": 190,
      "sellerPositivePercent": 99.4,
      "scrapedAt": "2026-09-27T08:00:00Z",
      "sellerDescriptionText": "Works perfectly. Minor scratches on screen, not visible when on. Joy-Cons have slight drift."
    },
    {
      "itemId": "300000000011",
      "url": "https://www.ebay.com/itm/300000000011",
      "title": "Nintendo Switch OLED Model White - Open Box, Unused",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Open box",
      "conditionId": 1500,
      "endedAt": "2026-09-17",
      "soldPrice": "265.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "265.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample11/s-l225.jpg",
      "sellerUsername": "dealsdirect_us",
      "sellerFeedbackScore": 15400,
      "sellerPositivePercent": 99.2,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000012",
      "url": "https://www.ebay.com/itm/300000000012",
      "title": "Nintendo Switch OLED Model Console White",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-15",
      "soldPrice": "95.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "95.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample12/s-l225.jpg",
      "sellerUsername": "quick.cash.store",
      "sellerFeedbackScore": 3,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000013",
      "url": "https://www.ebay.com/itm/300000000013",
      "title": "Nintendo Switch OLED Model White Console (UK plug)",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-21",
      "soldPrice": "189.00",
      "soldCurrency": "GBP",
      "shippingPrice": "0.00",
      "shippingCurrency": "GBP",
      "shippingType": "Free",
      "totalPrice": "189.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample13/s-l225.jpg",
      "sellerUsername": "uk_console_deals",
      "sellerFeedbackScore": 640,
      "sellerPositivePercent": 99.8,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000014",
      "url": "https://www.ebay.com/itm/300000000014",
      "title": "Nintendo Switch OLED Model w/ White Joy-Con - Tested",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-12",
      "soldPrice": "229.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "229.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample14/s-l225.jpg",
      "sellerUsername": "pawnshop_pdx",
      "sellerFeedbackScore": 4380,
      "sellerPositivePercent": 99.1,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000015",
      "url": "https://www.ebay.com/itm/300000000015",
      "title": "Nintendo Switch OLED Handheld Console White, Dock, Charger",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-09",
      "soldPrice": "235.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "235.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample15/s-l225.jpg",
      "sellerUsername": "familygames4u",
      "sellerFeedbackScore": 58,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000016",
      "url": "https://www.ebay.com/itm/300000000016",
      "title": "Nintendo Switch OLED Model Neon Red/Blue - Brand New Sealed",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-08",
      "soldPrice": "299.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "299.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample16/s-l225.jpg",
      "sellerUsername": "bigbox_liquidation",
      "sellerFeedbackScore": 22100,
      "sellerPositivePercent": 98.8,
      "scrapedAt": "2026-09-27T08:00:00Z"
    }
  ],
  "discoveryActorId": "caffein.dev/ebay-sold-listings",
  "discoveryInput": {}
}
```

# Actor output Schema

## `qualified` (type: `string`):

All new clean comps as JSON, best match first.

## `sheet` (type: `string`):

The same comps as a spreadsheet.

## `priceReport` (type: `string`):

Per keyword: n, min, p10–p90, median, mean, per-condition medians, auction vs Buy-It-Now median, sales per day, trend, suggested list price, max buy price, confidence A–D, a one-paragraph summary and the change vs the last run.

## `runSummary` (type: `string`):

JSON record with the funnel (loaded -> cleaned -> AI-checked -> delivered), the rejected rows per reason (parts, box only, accessory, lot, variant, Best Offer, currency, outlier, duplicate — never charged), charged events, free-tier comps used and remaining, webhook delivery counts and the dedupe store size.

# 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 = {
    "sourceMode": "list",
    "itemDescription": "Nintendo Switch OLED console with dock and Joy-Cons, working, any colour",
    "maxDiscoveryChargeUsd": 0.5,
    "itemsList": [
        {
            "itemId": "300000000001",
            "url": "https://www.ebay.com/itm/300000000001",
            "title": "Nintendo Switch OLED Model White Console with Dock and Joy-Cons",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-24",
            "soldPrice": "219.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "219.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample1/s-l225.jpg",
            "sellerUsername": "retro_flips_22",
            "sellerFeedbackScore": 1200,
            "sellerPositivePercent": 99.6,
            "scrapedAt": "2026-09-27T08:00:00Z",
            "itemSpecifics": {
                "Brand": "Nintendo",
                "Model": "Nintendo Switch OLED",
                "Color": "White",
                "Storage Capacity": "64 GB"
            }
        },
        {
            "itemId": "300000000002",
            "url": "https://www.ebay.com/itm/300000000002",
            "title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-22",
            "soldPrice": "199.50",
            "soldCurrency": "USD",
            "shippingPrice": "12.00",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "211.50",
            "listingType": "auction",
            "isBestOfferAccepted": false,
            "buyingFormat": "AUCTION",
            "bidCount": 23,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample2/s-l225.jpg",
            "sellerUsername": "garage.sale.gamer",
            "sellerFeedbackScore": 341,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000003",
            "url": "https://www.ebay.com/itm/300000000003",
            "title": "NEW Nintendo Switch OLED Model White - Factory Sealed",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-25",
            "soldPrice": "309.99",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "309.99",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample3/s-l225.jpg",
            "sellerUsername": "dealsdirect_us",
            "sellerFeedbackScore": 15400,
            "sellerPositivePercent": 99.2,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000004",
            "url": "https://www.ebay.com/itm/300000000004",
            "title": "Nintendo Switch OLED Console For Parts Not Working - No Power",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "For parts or not working",
            "conditionId": 7000,
            "endedAt": "2026-09-20",
            "soldPrice": "89.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "89.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample4/s-l225.jpg",
            "sellerUsername": "fixit_fred",
            "sellerFeedbackScore": 88,
            "sellerPositivePercent": 98.9,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000005",
            "url": "https://www.ebay.com/itm/300000000005",
            "title": "Nintendo Switch OLED Box Only - Empty Box No Console",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-19",
            "soldPrice": "14.99",
            "soldCurrency": "USD",
            "shippingPrice": "4.99",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "19.98",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample5/s-l225.jpg",
            "sellerUsername": "collect_n_ship",
            "sellerFeedbackScore": 2210,
            "sellerPositivePercent": 99.9,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000006",
            "url": "https://www.ebay.com/itm/300000000006",
            "title": "Carrying Case for Nintendo Switch OLED - Hard Shell Travel Case",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-21",
            "soldPrice": "16.99",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "16.99",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample6/s-l225.jpg",
            "sellerUsername": "accessory_hub",
            "sellerFeedbackScore": 9021,
            "sellerPositivePercent": 98.7,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000007",
            "url": "https://www.ebay.com/itm/300000000007",
            "title": "Nintendo Switch Lite Turquoise Handheld Console",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-23",
            "soldPrice": "139.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "139.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample7/s-l225.jpg",
            "sellerUsername": "retro_flips_22",
            "sellerFeedbackScore": 1200,
            "sellerPositivePercent": 99.6,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000008",
            "url": "https://www.ebay.com/itm/300000000008",
            "title": "Lot of 2 Nintendo Switch OLED Consoles White + Neon",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-18",
            "soldPrice": "455.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "455.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample8/s-l225.jpg",
            "sellerUsername": "bulk_buys_llc",
            "sellerFeedbackScore": 512,
            "sellerPositivePercent": 97.4,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000009",
            "url": "https://www.ebay.com/itm/300000000009",
            "title": "Nintendo Switch OLED White 64GB with Dock - Excellent",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-26",
            "soldPrice": "240.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "240.00",
            "listingType": "best_offer_accepted",
            "isBestOfferAccepted": true,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample9/s-l225.jpg",
            "sellerUsername": "thrift_to_profit",
            "sellerFeedbackScore": 77,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000010",
            "url": "https://www.ebay.com/itm/300000000010",
            "title": "Nintendo Switch OLED Console Neon - minor scratches on screen",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-16",
            "soldPrice": "185.00",
            "soldCurrency": "USD",
            "shippingPrice": "14.00",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "199.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample10/s-l225.jpg",
            "sellerUsername": "weekend.reseller",
            "sellerFeedbackScore": 190,
            "sellerPositivePercent": 99.4,
            "scrapedAt": "2026-09-27T08:00:00Z",
            "sellerDescriptionText": "Works perfectly. Minor scratches on screen, not visible when on. Joy-Cons have slight drift."
        },
        {
            "itemId": "300000000011",
            "url": "https://www.ebay.com/itm/300000000011",
            "title": "Nintendo Switch OLED Model White - Open Box, Unused",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Open box",
            "conditionId": 1500,
            "endedAt": "2026-09-17",
            "soldPrice": "265.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "265.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample11/s-l225.jpg",
            "sellerUsername": "dealsdirect_us",
            "sellerFeedbackScore": 15400,
            "sellerPositivePercent": 99.2,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000012",
            "url": "https://www.ebay.com/itm/300000000012",
            "title": "Nintendo Switch OLED Model Console White",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-15",
            "soldPrice": "95.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "95.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample12/s-l225.jpg",
            "sellerUsername": "quick.cash.store",
            "sellerFeedbackScore": 3,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000013",
            "url": "https://www.ebay.com/itm/300000000013",
            "title": "Nintendo Switch OLED Model White Console (UK plug)",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-21",
            "soldPrice": "189.00",
            "soldCurrency": "GBP",
            "shippingPrice": "0.00",
            "shippingCurrency": "GBP",
            "shippingType": "Free",
            "totalPrice": "189.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample13/s-l225.jpg",
            "sellerUsername": "uk_console_deals",
            "sellerFeedbackScore": 640,
            "sellerPositivePercent": 99.8,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000014",
            "url": "https://www.ebay.com/itm/300000000014",
            "title": "Nintendo Switch OLED Model w/ White Joy-Con - Tested",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-12",
            "soldPrice": "229.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "229.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample14/s-l225.jpg",
            "sellerUsername": "pawnshop_pdx",
            "sellerFeedbackScore": 4380,
            "sellerPositivePercent": 99.1,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000015",
            "url": "https://www.ebay.com/itm/300000000015",
            "title": "Nintendo Switch OLED Handheld Console White, Dock, Charger",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-09",
            "soldPrice": "235.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "235.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample15/s-l225.jpg",
            "sellerUsername": "familygames4u",
            "sellerFeedbackScore": 58,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z"
        },
        {
            "itemId": "300000000016",
            "url": "https://www.ebay.com/itm/300000000016",
            "title": "Nintendo Switch OLED Model Neon Red/Blue - Brand New Sealed",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-08",
            "soldPrice": "299.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "299.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": false,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": null,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample16/s-l225.jpg",
            "sellerUsername": "bigbox_liquidation",
            "sellerFeedbackScore": 22100,
            "sellerPositivePercent": 98.8,
            "scrapedAt": "2026-09-27T08:00:00Z"
        }
    ],
    "discoveryInput": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("rich_minds/ebay-sold-comps-ai").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 = {
    "sourceMode": "list",
    "itemDescription": "Nintendo Switch OLED console with dock and Joy-Cons, working, any colour",
    "maxDiscoveryChargeUsd": 0.5,
    "itemsList": [
        {
            "itemId": "300000000001",
            "url": "https://www.ebay.com/itm/300000000001",
            "title": "Nintendo Switch OLED Model White Console with Dock and Joy-Cons",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-24",
            "soldPrice": "219.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "219.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample1/s-l225.jpg",
            "sellerUsername": "retro_flips_22",
            "sellerFeedbackScore": 1200,
            "sellerPositivePercent": 99.6,
            "scrapedAt": "2026-09-27T08:00:00Z",
            "itemSpecifics": {
                "Brand": "Nintendo",
                "Model": "Nintendo Switch OLED",
                "Color": "White",
                "Storage Capacity": "64 GB",
            },
        },
        {
            "itemId": "300000000002",
            "url": "https://www.ebay.com/itm/300000000002",
            "title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-22",
            "soldPrice": "199.50",
            "soldCurrency": "USD",
            "shippingPrice": "12.00",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "211.50",
            "listingType": "auction",
            "isBestOfferAccepted": False,
            "buyingFormat": "AUCTION",
            "bidCount": 23,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample2/s-l225.jpg",
            "sellerUsername": "garage.sale.gamer",
            "sellerFeedbackScore": 341,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000003",
            "url": "https://www.ebay.com/itm/300000000003",
            "title": "NEW Nintendo Switch OLED Model White - Factory Sealed",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-25",
            "soldPrice": "309.99",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "309.99",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample3/s-l225.jpg",
            "sellerUsername": "dealsdirect_us",
            "sellerFeedbackScore": 15400,
            "sellerPositivePercent": 99.2,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000004",
            "url": "https://www.ebay.com/itm/300000000004",
            "title": "Nintendo Switch OLED Console For Parts Not Working - No Power",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "For parts or not working",
            "conditionId": 7000,
            "endedAt": "2026-09-20",
            "soldPrice": "89.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "89.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample4/s-l225.jpg",
            "sellerUsername": "fixit_fred",
            "sellerFeedbackScore": 88,
            "sellerPositivePercent": 98.9,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000005",
            "url": "https://www.ebay.com/itm/300000000005",
            "title": "Nintendo Switch OLED Box Only - Empty Box No Console",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-19",
            "soldPrice": "14.99",
            "soldCurrency": "USD",
            "shippingPrice": "4.99",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "19.98",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample5/s-l225.jpg",
            "sellerUsername": "collect_n_ship",
            "sellerFeedbackScore": 2210,
            "sellerPositivePercent": 99.9,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000006",
            "url": "https://www.ebay.com/itm/300000000006",
            "title": "Carrying Case for Nintendo Switch OLED - Hard Shell Travel Case",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-21",
            "soldPrice": "16.99",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "16.99",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample6/s-l225.jpg",
            "sellerUsername": "accessory_hub",
            "sellerFeedbackScore": 9021,
            "sellerPositivePercent": 98.7,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000007",
            "url": "https://www.ebay.com/itm/300000000007",
            "title": "Nintendo Switch Lite Turquoise Handheld Console",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-23",
            "soldPrice": "139.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "139.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample7/s-l225.jpg",
            "sellerUsername": "retro_flips_22",
            "sellerFeedbackScore": 1200,
            "sellerPositivePercent": 99.6,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000008",
            "url": "https://www.ebay.com/itm/300000000008",
            "title": "Lot of 2 Nintendo Switch OLED Consoles White + Neon",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-18",
            "soldPrice": "455.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "455.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample8/s-l225.jpg",
            "sellerUsername": "bulk_buys_llc",
            "sellerFeedbackScore": 512,
            "sellerPositivePercent": 97.4,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000009",
            "url": "https://www.ebay.com/itm/300000000009",
            "title": "Nintendo Switch OLED White 64GB with Dock - Excellent",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-26",
            "soldPrice": "240.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "240.00",
            "listingType": "best_offer_accepted",
            "isBestOfferAccepted": True,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample9/s-l225.jpg",
            "sellerUsername": "thrift_to_profit",
            "sellerFeedbackScore": 77,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000010",
            "url": "https://www.ebay.com/itm/300000000010",
            "title": "Nintendo Switch OLED Console Neon - minor scratches on screen",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-16",
            "soldPrice": "185.00",
            "soldCurrency": "USD",
            "shippingPrice": "14.00",
            "shippingCurrency": "USD",
            "shippingType": "Standard",
            "totalPrice": "199.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample10/s-l225.jpg",
            "sellerUsername": "weekend.reseller",
            "sellerFeedbackScore": 190,
            "sellerPositivePercent": 99.4,
            "scrapedAt": "2026-09-27T08:00:00Z",
            "sellerDescriptionText": "Works perfectly. Minor scratches on screen, not visible when on. Joy-Cons have slight drift.",
        },
        {
            "itemId": "300000000011",
            "url": "https://www.ebay.com/itm/300000000011",
            "title": "Nintendo Switch OLED Model White - Open Box, Unused",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Open box",
            "conditionId": 1500,
            "endedAt": "2026-09-17",
            "soldPrice": "265.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "265.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample11/s-l225.jpg",
            "sellerUsername": "dealsdirect_us",
            "sellerFeedbackScore": 15400,
            "sellerPositivePercent": 99.2,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000012",
            "url": "https://www.ebay.com/itm/300000000012",
            "title": "Nintendo Switch OLED Model Console White",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-15",
            "soldPrice": "95.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "95.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample12/s-l225.jpg",
            "sellerUsername": "quick.cash.store",
            "sellerFeedbackScore": 3,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000013",
            "url": "https://www.ebay.com/itm/300000000013",
            "title": "Nintendo Switch OLED Model White Console (UK plug)",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-21",
            "soldPrice": "189.00",
            "soldCurrency": "GBP",
            "shippingPrice": "0.00",
            "shippingCurrency": "GBP",
            "shippingType": "Free",
            "totalPrice": "189.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample13/s-l225.jpg",
            "sellerUsername": "uk_console_deals",
            "sellerFeedbackScore": 640,
            "sellerPositivePercent": 99.8,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000014",
            "url": "https://www.ebay.com/itm/300000000014",
            "title": "Nintendo Switch OLED Model w/ White Joy-Con - Tested",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-12",
            "soldPrice": "229.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "229.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample14/s-l225.jpg",
            "sellerUsername": "pawnshop_pdx",
            "sellerFeedbackScore": 4380,
            "sellerPositivePercent": 99.1,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000015",
            "url": "https://www.ebay.com/itm/300000000015",
            "title": "Nintendo Switch OLED Handheld Console White, Dock, Charger",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "Pre-Owned",
            "conditionId": 3000,
            "endedAt": "2026-09-09",
            "soldPrice": "235.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "235.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample15/s-l225.jpg",
            "sellerUsername": "familygames4u",
            "sellerFeedbackScore": 58,
            "sellerPositivePercent": 100,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
        {
            "itemId": "300000000016",
            "url": "https://www.ebay.com/itm/300000000016",
            "title": "Nintendo Switch OLED Model Neon Red/Blue - Brand New Sealed",
            "keyword": "nintendo switch oled",
            "categoryId": "139971",
            "category": "Video Game Consoles",
            "condition": "New",
            "conditionId": 1000,
            "endedAt": "2026-09-08",
            "soldPrice": "299.00",
            "soldCurrency": "USD",
            "shippingPrice": "0.00",
            "shippingCurrency": "USD",
            "shippingType": "Free",
            "totalPrice": "299.00",
            "listingType": "fixed_price",
            "isBestOfferAccepted": False,
            "buyingFormat": "FIXED_PRICE",
            "bidCount": None,
            "thumbnailUrl": "https://i.ebayimg.com/images/g/sample16/s-l225.jpg",
            "sellerUsername": "bigbox_liquidation",
            "sellerFeedbackScore": 22100,
            "sellerPositivePercent": 98.8,
            "scrapedAt": "2026-09-27T08:00:00Z",
        },
    ],
    "discoveryInput": {},
}

# Run the Actor and wait for it to finish
run = client.actor("rich_minds/ebay-sold-comps-ai").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 '{
  "sourceMode": "list",
  "itemDescription": "Nintendo Switch OLED console with dock and Joy-Cons, working, any colour",
  "maxDiscoveryChargeUsd": 0.5,
  "itemsList": [
    {
      "itemId": "300000000001",
      "url": "https://www.ebay.com/itm/300000000001",
      "title": "Nintendo Switch OLED Model White Console with Dock and Joy-Cons",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-24",
      "soldPrice": "219.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "219.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample1/s-l225.jpg",
      "sellerUsername": "retro_flips_22",
      "sellerFeedbackScore": 1200,
      "sellerPositivePercent": 99.6,
      "scrapedAt": "2026-09-27T08:00:00Z",
      "itemSpecifics": {
        "Brand": "Nintendo",
        "Model": "Nintendo Switch OLED",
        "Color": "White",
        "Storage Capacity": "64 GB"
      }
    },
    {
      "itemId": "300000000002",
      "url": "https://www.ebay.com/itm/300000000002",
      "title": "Nintendo Switch OLED 64GB Neon Red/Blue - Tested, Works Great",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-22",
      "soldPrice": "199.50",
      "soldCurrency": "USD",
      "shippingPrice": "12.00",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "211.50",
      "listingType": "auction",
      "isBestOfferAccepted": false,
      "buyingFormat": "AUCTION",
      "bidCount": 23,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample2/s-l225.jpg",
      "sellerUsername": "garage.sale.gamer",
      "sellerFeedbackScore": 341,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000003",
      "url": "https://www.ebay.com/itm/300000000003",
      "title": "NEW Nintendo Switch OLED Model White - Factory Sealed",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-25",
      "soldPrice": "309.99",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "309.99",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample3/s-l225.jpg",
      "sellerUsername": "dealsdirect_us",
      "sellerFeedbackScore": 15400,
      "sellerPositivePercent": 99.2,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000004",
      "url": "https://www.ebay.com/itm/300000000004",
      "title": "Nintendo Switch OLED Console For Parts Not Working - No Power",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "For parts or not working",
      "conditionId": 7000,
      "endedAt": "2026-09-20",
      "soldPrice": "89.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "89.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample4/s-l225.jpg",
      "sellerUsername": "fixit_fred",
      "sellerFeedbackScore": 88,
      "sellerPositivePercent": 98.9,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000005",
      "url": "https://www.ebay.com/itm/300000000005",
      "title": "Nintendo Switch OLED Box Only - Empty Box No Console",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-19",
      "soldPrice": "14.99",
      "soldCurrency": "USD",
      "shippingPrice": "4.99",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "19.98",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample5/s-l225.jpg",
      "sellerUsername": "collect_n_ship",
      "sellerFeedbackScore": 2210,
      "sellerPositivePercent": 99.9,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000006",
      "url": "https://www.ebay.com/itm/300000000006",
      "title": "Carrying Case for Nintendo Switch OLED - Hard Shell Travel Case",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-21",
      "soldPrice": "16.99",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "16.99",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample6/s-l225.jpg",
      "sellerUsername": "accessory_hub",
      "sellerFeedbackScore": 9021,
      "sellerPositivePercent": 98.7,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000007",
      "url": "https://www.ebay.com/itm/300000000007",
      "title": "Nintendo Switch Lite Turquoise Handheld Console",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-23",
      "soldPrice": "139.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "139.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample7/s-l225.jpg",
      "sellerUsername": "retro_flips_22",
      "sellerFeedbackScore": 1200,
      "sellerPositivePercent": 99.6,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000008",
      "url": "https://www.ebay.com/itm/300000000008",
      "title": "Lot of 2 Nintendo Switch OLED Consoles White + Neon",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-18",
      "soldPrice": "455.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "455.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample8/s-l225.jpg",
      "sellerUsername": "bulk_buys_llc",
      "sellerFeedbackScore": 512,
      "sellerPositivePercent": 97.4,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000009",
      "url": "https://www.ebay.com/itm/300000000009",
      "title": "Nintendo Switch OLED White 64GB with Dock - Excellent",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-26",
      "soldPrice": "240.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "240.00",
      "listingType": "best_offer_accepted",
      "isBestOfferAccepted": true,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample9/s-l225.jpg",
      "sellerUsername": "thrift_to_profit",
      "sellerFeedbackScore": 77,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000010",
      "url": "https://www.ebay.com/itm/300000000010",
      "title": "Nintendo Switch OLED Console Neon - minor scratches on screen",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-16",
      "soldPrice": "185.00",
      "soldCurrency": "USD",
      "shippingPrice": "14.00",
      "shippingCurrency": "USD",
      "shippingType": "Standard",
      "totalPrice": "199.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample10/s-l225.jpg",
      "sellerUsername": "weekend.reseller",
      "sellerFeedbackScore": 190,
      "sellerPositivePercent": 99.4,
      "scrapedAt": "2026-09-27T08:00:00Z",
      "sellerDescriptionText": "Works perfectly. Minor scratches on screen, not visible when on. Joy-Cons have slight drift."
    },
    {
      "itemId": "300000000011",
      "url": "https://www.ebay.com/itm/300000000011",
      "title": "Nintendo Switch OLED Model White - Open Box, Unused",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Open box",
      "conditionId": 1500,
      "endedAt": "2026-09-17",
      "soldPrice": "265.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "265.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample11/s-l225.jpg",
      "sellerUsername": "dealsdirect_us",
      "sellerFeedbackScore": 15400,
      "sellerPositivePercent": 99.2,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000012",
      "url": "https://www.ebay.com/itm/300000000012",
      "title": "Nintendo Switch OLED Model Console White",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-15",
      "soldPrice": "95.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "95.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample12/s-l225.jpg",
      "sellerUsername": "quick.cash.store",
      "sellerFeedbackScore": 3,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000013",
      "url": "https://www.ebay.com/itm/300000000013",
      "title": "Nintendo Switch OLED Model White Console (UK plug)",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-21",
      "soldPrice": "189.00",
      "soldCurrency": "GBP",
      "shippingPrice": "0.00",
      "shippingCurrency": "GBP",
      "shippingType": "Free",
      "totalPrice": "189.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample13/s-l225.jpg",
      "sellerUsername": "uk_console_deals",
      "sellerFeedbackScore": 640,
      "sellerPositivePercent": 99.8,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000014",
      "url": "https://www.ebay.com/itm/300000000014",
      "title": "Nintendo Switch OLED Model w/ White Joy-Con - Tested",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-12",
      "soldPrice": "229.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "229.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample14/s-l225.jpg",
      "sellerUsername": "pawnshop_pdx",
      "sellerFeedbackScore": 4380,
      "sellerPositivePercent": 99.1,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000015",
      "url": "https://www.ebay.com/itm/300000000015",
      "title": "Nintendo Switch OLED Handheld Console White, Dock, Charger",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "Pre-Owned",
      "conditionId": 3000,
      "endedAt": "2026-09-09",
      "soldPrice": "235.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "235.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample15/s-l225.jpg",
      "sellerUsername": "familygames4u",
      "sellerFeedbackScore": 58,
      "sellerPositivePercent": 100,
      "scrapedAt": "2026-09-27T08:00:00Z"
    },
    {
      "itemId": "300000000016",
      "url": "https://www.ebay.com/itm/300000000016",
      "title": "Nintendo Switch OLED Model Neon Red/Blue - Brand New Sealed",
      "keyword": "nintendo switch oled",
      "categoryId": "139971",
      "category": "Video Game Consoles",
      "condition": "New",
      "conditionId": 1000,
      "endedAt": "2026-09-08",
      "soldPrice": "299.00",
      "soldCurrency": "USD",
      "shippingPrice": "0.00",
      "shippingCurrency": "USD",
      "shippingType": "Free",
      "totalPrice": "299.00",
      "listingType": "fixed_price",
      "isBestOfferAccepted": false,
      "buyingFormat": "FIXED_PRICE",
      "bidCount": null,
      "thumbnailUrl": "https://i.ebayimg.com/images/g/sample16/s-l225.jpg",
      "sellerUsername": "bigbox_liquidation",
      "sellerFeedbackScore": 22100,
      "sellerPositivePercent": 98.8,
      "scrapedAt": "2026-09-27T08:00:00Z"
    }
  ],
  "discoveryInput": {}
}' |
apify call rich_minds/ebay-sold-comps-ai --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rich_minds/ebay-sold-comps-ai"
        }
    }
}
```

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/SQrWu1rge4dY4iCbF/builds/dOqigWSpK4QlDRIPY/openapi.json
