# The Market Classic Car Auctions Scraper - Prices & Results (`normdata/themarket-scraper`) Actor

Scrape The Market (by Bonhams) classic car auctions: sold prices, top bids, bid counts, reserve status, make, model, year, plate, location and end dates. Add chassis, engine, mileage, estimates, full condition reports, key facts, video and bid history. 15 filters, only new lots.

- **URL**: https://apify.com/normdata/themarket-scraper.md
- **Developed by:** [Norm Data](https://apify.com/normdata) (community)
- **Categories:** E-commerce, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 auction lots

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

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

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

## How to integrate an Actor?

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

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

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

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

# README

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 🏁 The Market Classic Car Auctions Scraper - Prices & Results

Extract every lot from **The Market** (themarket.co.uk, by Bonhams), the UK online classic car auction, with about **5,750 lots** since 2016: **sold results, live auctions, coming soon and sealed bids**. For each lot you get the **sold price, top bid, number of bids, next minimum bid, buy now price, currency, reserve status (no reserve, met, close, not close), year, make, model, tagline, plate, steering, location, country and auction start and end times**. Turn on **Lot details** for **chassis number, engine, gearbox, fuel, colours, mileage, estimates, buyer fees, seller type, specialist review, the full condition report (background, exterior, interior, mechanical, history, verdict), key facts, photo and watcher counts, video, main photos and the full bid history**. Search with **15 filters**, sort 7 ways, or paste lot, list, search and make links, and run it on a schedule to get **only new lots**.

### 🎯 Who uses it?

#### 📈 Classic car valuation and price guide teams

Build price histories by make, model and year from every result on The Market, with top bids, reserve status, estimates and bid counts.

#### 🚗 Dealers, traders and collectors

Watch live auctions and coming soon lots, see how bidding went on cars like yours, and find cars that sold after the auction.

#### 🏦 Insurers, lenders and appraisers

Back agreed values with real sale prices, chassis numbers, mileage and detailed condition reports.

#### 📊 Market analysts and journalists

Track demand by make and era: bids per lot, watchers, no reserve share and prices across GBP, EUR, USD and CHF sales.

### ✨ What it does

- **The whole site.** About 5,700 past results, plus every live, coming soon and sealed bids lot. Every lot comes once.
- **15 filters.** Status, search words, make, model, model year range, price range, currency, car location, steering, no reserve only, minimum bids and auction end date range.
- **7 sorts.** End date (latest or oldest first), price high or low, model year new or old, most bids.
- **Lot details (add-on).** Each lot page is read for chassis, engine, mileage, estimates, the full condition report, key facts, video, photos, watchers and every bid with its time.
- **Or paste links.** Lot pages, the site's lists (results, live, coming soon, sealed, no reserve), searches and make pages like /auctions/porsche. Filters are not used with links.
- **Monitoring:** run it on a schedule with **Only new lots**, and each run saves only the lots you haven't received yet.

### 🏆 Why this scraper

- **Clean, flat, typed data.** Prices, years, bids and mileage are numbers, dates are ISO (UTC), yes/no fields are true or false. 60 fields, one row per lot.
- **Fast.** The whole archive (about 5,750 lots) in about a minute, 1,000 lots with lot details in under a minute.
- **Bid history without bidders.** Every bid amount and time, never who placed it.
- **Nothing to set up.** No proxy, no login.

### ⚖️ How it compares

| | This Actor | rastriq/themarket-scraper | getascraper/themarket-scraper |
| --- | --- | --- | --- |
| Filters | 15 (status, search, make, model, year, price, currency, country, steering, no reserve, bids, end date) | 2 (make, year) | 10 |
| Full condition report sections | ✅ 7 sections | ❌ | ✅ |
| Bid history (amounts and times) | ✅ | ❌ | ✅ |
| Seller type, watchers, photo count | ✅ | ❌ | ✅ |
| Sold after auction, price hidden flags | ✅ | ❌ | Sold after auction only |
| Links (lots, lists, searches, make pages) | ✅ | ❌ | ✅ |
| Only new lots (monitoring) | ✅ | ❌ | ✅ |
| Proxy needed | No | Optional | No |

Compared on their public input and output (October 2026).

### 📦 What data you get

| Field | Description |
| --- | --- |
| `imageUrl` | Main photo in full size. |
| `title` | Lot title, like "1958 Morris Minor 1000". |
| `year`, `make`, `model` | Model year, make and model. |
| `tagline` | Short headline of the lot, like "Multiple Upgrades - Immaculate". |
| `status` | Sold, Not sold, Live, Coming soon or Withdrawn. |
| `price`, `highestBid`, `bidCount`, `nextMinimumBid`, `buyNowPrice`, `currency` | Sold price (sold lots), top bid, number of bids, next minimum bid (live lots), buy now price and currency code. |
| `reserveStatus` | No reserve, Reserve met, Reserve close or Reserve not close. |
| `saleType` | Online auction or Sealed bids. |
| `lotNumber`, `registration` | Lot number and registration plate. |
| `steering` | RHD or LHD. |
| `location`, `country`, `countryCode` | Where the car is: place, country and country code. |
| `lotId` | The Market lot ID. |
| `chassisNumber`, `engine`, `gearbox`, `fuelType` | *(Lot details)* Chassis number (VIN), engine, gearbox and fuel. |
| `exteriorColour`, `interiorTrim` | *(Lot details)* Exterior colour and interior trim. |
| `mileage`, `mileageUnit`, `registrationCountry` | *(Lot details)* Mileage, its unit (mi or km), and the country the car is registered in. |
| `estimateLow`, `estimateHigh` | *(Lot details)* Low and high estimate (when the site shows them). |
| `summary`, `specialistQuote`, `specialist` | *(Lot details)* Seller summary, specialist review and the specialist name. |
| `background`, `aboutTheCar`, `exteriorReport`, `interiorReport`, `mechanicalReport`, `historyReport`, `verdict` | *(Lot details)* Full write-up: background of the model, about the car, exterior, interior, mechanical (underneath), history and the verdict. |
| `sellerType` | *(Lot details)* Private or Trade seller. |
| `photoCount`, `watchCount` | *(Lot details)* Number of photos in the full gallery and number of people watching the lot. |
| `withoutReserve`, `reserveLowered` | Offered without reserve, reserve lowered during the auction. |
| `priceHidden` | Sold, but the site hides the price. |
| `soldAfterAuction` | Sold after the bidding ended (the price is above the top bid). |
| `mileageIndicated` | *(Lot details)* The mileage is only what the odometer shows (not verified). |
| `buyerPaysFees` | *(Lot details)* The buyer pays fees on top of the price. |
| `url` | Link to the lot. |
| `videoUrl` | *(Lot details)* Video of the car. |
| `keyFacts` | *(Lot details)* Key facts, like "Fresh MoT" or "No Buyer's Fees". |
| `galleryImages` | *(Lot details)* The main photos of the lot in full size (up to 7). |
| `bidHistory` | *(Lot details)* Every bid: amount, time and whether it was the winning bid. No bidder names. |
| `auctionStart`, `auctionEnd` | When bidding opens and ends (UTC). |
| `scrapedAt` | When this row was saved. |
| `error` | Only present when a row failed. The fields that loaded are still there. |

Fields marked *Lot details* only appear when that add-on is on.

#### Example row (trimmed)

```json
{
  "imageUrl": "https://cdn.themarket.co.uk/26eec814-cc9d-44ba-be3b-0b825f080edc/21e96a24-3431-4658-a745-8de1fd335215.jpg",
  "title": "1969 Jaguar E Type S2 OTS",
  "year": 1969,
  "make": "Jaguar",
  "model": "E Type S2 OTS",
  "tagline": "A sharp looking example, with lots of history.",
  "status": "Sold",
  "price": 42000,
  "highestBid": 40250,
  "bidCount": 17,
  "buyNowPrice": 45000,
  "currency": "GBP",
  "reserveStatus": "Reserve close",
  "saleType": "Online auction",
  "lotNumber": 5216,
  "registration": "OBV 592H",
  "steering": "RHD",
  "location": "THE MARKET HQ",
  "country": "United Kingdom",
  "countryCode": "GB",
  "lotId": "26eec814-cc9d-44ba-be3b-0b825f080edc",
  "chassisNumber": "P1R11645",
  "engine": "4200cc",
  "gearbox": "manual",
  "fuelType": "Petrol",
  "exteriorColour": "Red",
  "interiorTrim": "Black Leather",
  "mileage": 85401,
  "mileageUnit": "mi",
  "registrationCountry": "GB",
  "estimateLow": 45000,
  "estimateHigh": 50000,
  "summary": "Great colours & great spec.",
  "specialistQuote": "Originally Dispatched to British Leyland Motors New York.",
  "specialist": "Paul Hegarty",
  "background": "Invariably in everyone’s top three of the best-looking cars ever made (and for Enzo Ferrari it famously took the number one spot), the Jaguar E Type boasts inch-perfect lines, ...",
  "aboutTheCar": "Eagle-eyed observers among you will have spotted that we’re describing this car as a ‘Roadster’, which is what the drop-top was called in the USA, rather than an OTS - or Open ...",
  "exteriorReport": "The car presents pretty well from a few metres away and the panel gaps and shut-lines are decent but, as you get closer, you’ll notice the odd dink and dimple here, and a few ...",
  "interiorReport": "The restoration of the interior is a very recent piece of work, which explains why it looks rather fresher than its exterior counterpart.\n\nThe new black leather upholstery has an ...",
  "mechanicalReport": "The engine bay is tidy and orderly, although we did notice a few drops of oil under the car, so maybe we can’t quite add clean and dry to the list of preferred adjectives. ...",
  "historyReport": "The car comes with a Jaguar Heritage Trust certificate, and all manner of bills, invoices and receipts attesting to both recent work and work carried out over previous decades. ...",
  "verdict": "Well, it may not have started out in life with the most desirable configuration – which is, of course, RHD, manual, OTS – but that’s how it is today and that should suit most ...",
  "sellerType": "Trade",
  "photoCount": 344,
  "watchCount": 95,
  "withoutReserve": false,
  "reserveLowered": false,
  "priceHidden": false,
  "soldAfterAuction": true,
  "mileageIndicated": false,
  "buyerPaysFees": false,
  "url": "https://www.themarket.co.uk/listings/jaguar/e-type-s2-ots/26eec814-cc9d-44ba-be3b-0b825f080edc",
  "videoUrl": "https://customer-39e8nqp1sorqt8hx.cloudflarestream.com/0fb97d3df7e545920d5d2cd4a3c1c4c0/iframe?poster=https%3A%2F%2Fcustomer-39e8nqp1sorqt8hx.cloudflarestream.com%2F0fb97d3df7e5459 ...",
  "keyFacts": ["No Buyer's Fees", "Imported in '88", "Large History of Original Invoices"],
  "galleryImages": [
    "https://cdn.themarket.co.uk/26eec814-cc9d-44ba-be3b-0b825f080edc/21e96a24-3431-4658-a745-8de1fd335215.jpg",
    "https://cdn.themarket.co.uk/26eec814-cc9d-44ba-be3b-0b825f080edc/1969-jaguar-e-type-s2-ots-s5lg5.jpg",
    "https://cdn.themarket.co.uk/26eec814-cc9d-44ba-be3b-0b825f080edc/1969-jaguar-e-type-s2-ots-6if7n.jpg"
  ],
  "bidHistory": [{ "amount": 40250, "time": "2026-09-07T10:40:05.000Z", "winning": true }],
  "auctionStart": "2026-08-31T08:00:00.000Z",
  "auctionEnd": "2026-09-21T09:24:54.000Z",
  "scrapedAt": "2026-10-22T19:39:48.795Z"
}
```

### 💡 Use cases

**Every Porsche 911 sold, highest price first:**

```json
{
  "statuses": ["sold"],
  "makes": ["Porsche"],
  "models": ["911"],
  "sortBy": "priceDesc"
}
```

**Live auctions right now, with the full condition report and bids:**

```json
{
  "statuses": ["live"],
  "includeDetails": true
}
```

**Land Rovers from 1970 to 1990 sold for 20,000 to 60,000 GBP in 2025:**

```json
{
  "statuses": ["sold"],
  "makes": ["Land Rover"],
  "yearFrom": 1970,
  "yearTo": 1990,
  "minPrice": 20000,
  "maxPrice": 60000,
  "currencies": ["GBP"],
  "endDateFrom": "2025-01-01",
  "endDateTo": "2025-12-31"
}
```

**Left-hand drive cars in the Netherlands, no reserve, with at least 30 bids:**

```json
{
  "lotCountries": ["NL"],
  "steering": "LHD",
  "withoutReserveOnly": true,
  "minBids": 30
}
```

**Search words, most bids first:**

```json
{
  "searchTerms": ["Mini Cooper", "E Type"],
  "sortBy": "mostBids"
}
```

**New lots every day (schedule this run):**

```json
{
  "statuses": ["comingSoon", "live"],
  "onlyNew": true,
  "monitorName": "themarket-daily"
}
```

**Links (filters are not used):**

```json
{
  "startUrls": [
    { "url": "https://www.themarket.co.uk/listings/morris/minor-1000/31560f21-0ce7-41dd-8b1d-c197e38d52a4" },
    { "url": "https://www.themarket.co.uk/auctions/live" },
    { "url": "https://www.themarket.co.uk/auctions/search-results?keywords=defender" },
    { "url": "https://www.themarket.co.uk/auctions/porsche" }
  ]
}
```

### ⚙️ How the input is organised

| Section | What it's for |
| --- | --- |
| **Maximum results** | Always first, caps the whole run. Empty means no limit. |
| **What to scrape** | Status, search words, sort by and lot details (chassis, engine, mileage, estimates, condition reports, bid history). |
| **Filters** | Makes, models, model year from, model year to, minimum price, maximum price, currencies, car located in, steering, only without reserve, minimum bids, auction end from and auction end to. |
| **Monitoring** | Only new lots and monitor name. |
| **Links** | Links instead of the fields above. Filters are ignored with links. |

### 💰 Pricing

Pay-per-event: a one-time **$0.003** when the run starts, plus a price per lot saved to your dataset. **Lot details** is an add-on, charged per lot only when you turn it on. The price depends on your Apify plan tier:

| Plan | Per lot | Lot details | Per 1,000 lots | With lot details |
| --- | --- | --- | --- | --- |
| Free | $0.014 | +$0.006 | $14 | $20 |
| Bronze | $0.012 | +$0.005 | $12 | $17 |
| Silver | $0.011 | +$0.004 | $11 | $15 |
| Gold | $0.010 | +$0.003 | $10 | $13 |

Lots left out by filters are free. New Apify accounts start with $5 in free credit. On the Free plan, a run saves up to 10 lots.

### 🚀 Run it

1. Create a free Apify account with $5 in credit.
2. Open The Market Classic Car Auctions Scraper.
3. Pick a status, search words or filters (or keep it empty for every lot), then click **Start**.
4. Export the results as CSV, Excel, JSON or XML from the Dataset tab.

### 🤖 Use with AI agents (MCP)

Connect the [Apify MCP server](https://mcp.apify.com) to Claude, ChatGPT, Cursor or any MCP client, then ask in plain words, for example: *"Get every Jaguar E Type sold on The Market, with price, bids and mileage"*. The agent runs this Actor and reads the results.

### 🔧 Troubleshooting

- **The log shows more lots than were saved.** The count in the log is the site's. Every filter is checked by the Actor, so fewer lots are kept.
- **Prices are in different currencies.** Each lot is in its sale's currency (`currency`): GBP, EUR, USD or CHF. The price filter and price sort use the number as it is, without converting.
- **Price means sold price or top bid.** `price` is only for sold lots. The price filter and sort use it, else the top bid (`highestBid`) for live and not sold lots.
- **A sold lot has no price.** The seller asked to hide it: `priceHidden` is true, and the top bid and bid history are left empty too.
- **Some fields are empty.** Older lots (2016 to 2021) often have no estimates, summary, specialist or start time. Coming soon lots have no bids yet. Sealed bids lots have no bid count. Mileage without a unit on the site has no `mileageUnit`.
- **Only up to 7 photos.** `galleryImages` holds the lot's main photos. The full gallery (often 300+) is loaded by the site's app only, so `photoCount` gives its size.

### ❓ FAQ

**How many lots are there?** About 5,750 as of October 2026: about 5,720 sold or not sold results, plus live, coming soon and sealed bids lots.

**Can I pick several makes or search words?** Yes. Any lot matching one of the values is kept, and duplicates are removed. "Mercedes" also finds Mercedes-Benz.

**What does soldAfterAuction mean?** The bidding ended below the reserve, but the car was sold afterwards. `price` is that later price, `highestBid` the top bid in the auction.

**Do I need a proxy?** No.

### 🛡️ Limits & responsible use

This Actor collects auction lots that The Market publishes on its website and keeps a moderate pace. It does not collect bidder, buyer or seller personal data: bid history has amounts and times only, and the specialist is only named. Use the data in line with The Market's terms and the law where you work.

### 📧 Contact

Questions, bugs or a field you need: norm.data.scrapers@gmail.com

### 🧪 Local development

```bash
bun install
bun scripts/gen-schemas.mjs
sh test/run.sh first '{"maxItems":10,"searchTerms":["Porsche"]}'
```

# Actor input Schema

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

Stop after this many lots in total. Leave empty for no limit. The Apify Free plan is always capped at 10.

## `statuses` (type: `array`):

Empty = every lot: past results (sold and not sold, sealed bids included), live auctions and coming soon.

## `searchTerms` (type: `array`):

Words to look for, like "Porsche 911" or "Land Rover". Uses the site search. Each one is a separate search.

## `sortBy` (type: `string`):

Empty = end date, latest first. Prices are compared as shown, each lot in its own currency.

## `includeDetails` (type: `boolean`):

Also read each lot page for its chassis number, engine, gearbox, fuel, colours, mileage, estimates, buyer fees, summary, specialist review and name, full write-up (background, exterior, interior, mechanical, history, verdict), key facts, video, main photos and every bid (amount and time). Charged per lot as an add-on.

## `makes` (type: `array`):

Car makes, like Porsche or Land Rover. "Mercedes" also finds Mercedes-Benz.

## `models` (type: `array`):

Words in the model name, like 911 or Defender.

## `yearFrom` (type: `integer`):

Oldest model year.

## `yearTo` (type: `integer`):

Newest model year.

## `minPrice` (type: `integer`):

Sold price, or the top bid when not sold or still live, in the lot currency.

## `maxPrice` (type: `integer`):

Sold price, or the top bid when not sold or still live, in the lot currency.

## `currencies` (type: `array`):

Keep only lots sold in these currencies.

## `lotCountries` (type: `array`):

Where the car is, as 2-letter country codes, like GB, NL, US or FR.

## `steering` (type: `string`):

Empty = both.

## `withoutReserveOnly` (type: `boolean`):

Keep only lots offered without reserve.

## `minBids` (type: `integer`):

Keep only lots with at least this many bids.

## `endDateFrom` (type: `string`):

Keep only auctions ending on or after this date, like 2024-01-01 or "1 year" back from today.

## `endDateTo` (type: `string`):

Keep only auctions ending on or before this date.

## `onlyNew` (type: `boolean`):

Skip lots saved by earlier runs with the same monitor name.

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

Runs with the same name share their history. Use a different name for each schedule.

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

Lot pages (https://www.themarket.co.uk/listings/porsche/911/...), lists (https://www.themarket.co.uk/auctions/results, /auctions/live, /auctions/coming-soon, /auctions/sealed, /auctions/no-reserve), searches (/auctions/search-results?keywords=porsche) or make pages (/auctions/porsche).

## Actor input object example

```json
{
  "maxItems": 10,
  "searchTerms": [
    "Porsche"
  ]
}
```

# Actor output Schema

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

No description

# API

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

## JavaScript example

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

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

// Prepare Actor input
const input = {
    "maxItems": 10,
    "searchTerms": [
        "Porsche"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/themarket-scraper").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 = {
    "maxItems": 10,
    "searchTerms": ["Porsche"],
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/themarket-scraper").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 '{
  "maxItems": 10,
  "searchTerms": [
    "Porsche"
  ]
}' |
apify call normdata/themarket-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/themarket-scraper"
        }
    }
}
```

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/YJ6rfPayPYzYc0BF7/builds/zfReIgw5IvYGG1Slm/openapi.json