# Wilsonsauctions Lots Search Scraper (`stealth_mode/wilsonsauctions-lots-search-scraper`) Actor

Scrape detailed auction lots from Wilson Auctions with precision. This tool collects titles, descriptions, estimated prices, bidding status, vehicle details, and 40+ fields per lot — perfect for auction analysts, dealers, and market researchers.

- **URL**: https://apify.com/stealth\_mode/wilsonsauctions-lots-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

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

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Wilson Auctions Lots Scraper: Extract Auction Item Data at Scale
---

### What Is Wilson Auctions?

Wilson Auctions is a leading online auction platform specializing in real-time asset sales across multiple categories including vehicles, equipment, machinery, and real estate. With thousands of active lots and frequent auction cycles, manual data collection is impractical. The **Wilson Auctions Lots Scraper** automates the extraction of auction item details, enabling you to build datasets for analysis, price tracking, and market intelligence.

---

### Overview

The **Wilson Auctions Lots Scraper** extracts comprehensive lot information from Wilson Auctions search result pages, transforming raw auction data into structured, analyzable records. It is designed for:

- **Auction analysts** monitoring market trends and pricing patterns
- **Vehicle dealers** tracking inventory and competitor pricing
- **Fleet managers** evaluating equipment availability and condition
- **Data researchers** building auction market datasets
- **Investment professionals** analyzing asset depreciation and value cycles

Key strengths include pagination support via filtered search URLs, configurable item limits, and robust error handling to continue collecting even when individual URLs fail.

---

### Input Format

The scraper accepts a JSON configuration object:

```json
{
  "urls": [
    "https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Input Parameters Explained

| Parameter | Type | Description | Example |
|---|---|---|---|
| `urls` | Array | Links to Wilson Auctions search result pages. Each URL targets a specific class, category, or page. | `["https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=1#lots"]` |
| `ignore_url_failures` | Boolean | If `true`, the scraper skips failed URLs and continues; if `false`, the run stops on first failure. Recommended: `true` for bulk operations. | `true` or `false` |
| `max_items_per_url` | Integer | Maximum number of lot records to collect per URL. Prevents excessive data collection while allowing controlled sampling. | `20`, `100`, `200` |

#### URL Construction Tips

- **By class:** Use `fs_class=%5B%22car%22%5D` for vehicles, adjust class name for equipment, real estate, etc.
- **By page:** Add `&fs_page=2` to fetch specific result pages.
- **Filtered searches:** Combine filters (price range, location, status) to narrow scope.

***

### Output Format

**Sample output**

```json
{
  "current_auction": {
    "end_date": "2026-06-22T12:30:00+01:00",
    "provisional_hold_duration_hours": null,
    "lot_id": 388604,
    "live_bid": false,
    "lot_number": 109,
    "event_type": "Timed Online",
    "allow_provisional_purchase": false,
    "branch": {
      "path_name": "glasgow",
      "name": "Glasgow",
      "id": 3,
      "region": {
        "invoice_prefix": "G",
        "name": "United Kingdom",
        "currency": "GBP",
        "id": "GB"
      }
    },
    "name": "Vehicle Auction",
    "currency": "GBP",
    "id": 4551,
    "buy_now_auction": false,
    "start_date": "2026-06-19T12:30:00+01:00",
    "status": "In Progress",
    "deposit_amount": 750
  },
  "class_details_field_specification": [
    {
      "filterable": false,
      "heading_text": "Reg Number",
      "name": "regNumber",
      "type": "RegNumber",
      "required": true,
      "required_message": "The reg number must be provided",
      "searchable": true
    },
    {
      "filterable": false,
      "heading_text": "Description",
      "name": "description",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": true,
      "heading_text": "Make",
      "name": "make",
      "type": "TextBox",
      "required": true,
      "required_message": "A Make must be provided",
      "searchable": true,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": true,
      "heading_text": "Model",
      "name": "model",
      "type": "TextBox",
      "required": true,
      "required_message": "A Model must be provided",
      "searchable": true,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": true,
      "name": "fuel",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": true,
      "name": "mileage",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "range",
        "range_aggregation_ranges": [
          {
            "to": 10000,
            "key": "Up to 10,000 miles"
          },
          {
            "to": 20000,
            "key": "Up to 20,000 miles"
          },
          {
            "to": 30000,
            "key": "Up to 30,000 miles"
          },
          {
            "to": 40000,
            "key": "Up to 40,000 miles"
          },
          {
            "to": 50000,
            "key": "Up to 50,000 miles"
          },
          {
            "to": 60000,
            "key": "Up to 60,000 miles"
          },
          {
            "to": 70000,
            "key": "Up to 70,000 miles"
          },
          {
            "to": 80000,
            "key": "Up to 80,000 miles"
          },
          {
            "to": 90000,
            "key": "Up to 90,000 miles"
          },
          {
            "to": 100000,
            "key": "Up to 100,000 miles"
          },
          {
            "to": 125000,
            "key": "Up to 125,000 miles"
          },
          {
            "to": 150000,
            "key": "Up to 150,000 miles"
          },
          {
            "to": 175000,
            "key": "Up to 175,000 miles"
          },
          {
            "to": 200000,
            "key": "Up to 200,000 miles"
          },
          {
            "from": 200001,
            "key": "Over 200,000 miles"
          }
        ],
        "search_facet_presentation": "one-of-many"
      }
    },
    {
      "filterable": false,
      "name": "mileageUnits",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "mileageChecked",
      "type": "CheckBox",
      "searchable": false
    },
    {
      "filterable": false,
      "heading_text": "Date registered",
      "name": "registrationDate",
      "type": "Date",
      "searchable": false
    },
    {
      "filterable": false,
      "heading_text": "Vehicle Identification Number",
      "name": "vin",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "mot",
      "type": "Date",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "taxExpiryDate",
      "type": "Date",
      "searchable": false
    },
    {
      "filterable": true,
      "heading_text": "Doors",
      "name": "doors",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": false,
      "name": "engineSize",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": true,
      "name": "transmission",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": true,
      "name": "bodyType",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": true,
      "name": "colour",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": false,
      "name": "aircon",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "gears",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "co2",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "seatingCapacity",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "masterKey",
      "type": "CheckBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "spareKey",
      "type": "CheckBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "numKeys",
      "type": "Number",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "formerKeepers",
      "type": "Number",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "capId",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "clean",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "average",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "below",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "retail",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "totalLoss",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": true,
      "name": "category",
      "type": "TextBox",
      "searchable": false,
      "filter_config": {
        "aggregation_type": "terms",
        "search_facet_presentation": "any"
      }
    },
    {
      "filterable": false,
      "name": "imported",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "exported",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "finance",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "police",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "stolen",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "highRisk",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "voidVrm",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "taxDesignation",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "mechWarranty",
      "options": {
        "options": [
          "Test Drive",
          "No Test Drive"
        ],
        "fill": true
      },
      "type": "Select",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "prevReg",
      "type": "Date",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "manufactured",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "serviceHistory",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "serviceHistoryLocation",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "serviceDate",
      "type": "Date",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "v5Location",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "motLocation",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "remarks",
      "type": "TextArea",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "notesOnFile",
      "type": "TextArea",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "oneLinkVehicleId",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "oneLinkAuctionSaleId",
      "type": "TextBox",
      "searchable": false
    },
    {
      "filterable": true,
      "name": "wheelchairAccessibleVehicle",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": true,
      "name": "isNotRunning",
      "type": "YesNoButtonGroup",
      "searchable": false
    },
    {
      "filterable": false,
      "name": "residualValue",
      "type": "TextBox",
      "searchable": false
    }
  ],
  "end_date": "2026-06-22T12:35:00+01:00",
  "appraisal_report_configuration": {
    "standard": true,
    "check_inspection": false,
    "image_capture": false,
    "wilsons_assured": false,
    "bvrla": false
  },
  "points_of_contact": [
    {
      "first_name": "Craig",
      "last_name": "Frizzel",
      "profile_photo_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXRhRGF0YSI6eyJmaWxlTmFtZSI6IkNyYWlnIEZyaXp6ZWwuanBnIiwiY29udGVudFR5cGUiOiJpbWFnZS9qcGVnIiwiY29udGVudExlbmd0aCI6MjEyNDd9LCJzM09iamVjdEtleSI6Ii8vcHVibGljX0NyYWlnIEZyaXp6ZWwuanBnXzIxMjQ3IiwiaWF0IjoxNjg2MjYwNjM0fQ.LDwdtogdnCc7segLN8G8SUhyI6cUMV7DB8i-HELRZZM",
      "phone": "+44 (0) 1294 833444",
      "email": "craigfrizzel@wilsonsauctions.com"
    },
    {
      "first_name": "John",
      "last_name": "Lyden",
      "profile_photo_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXRhRGF0YSI6eyJmaWxlTmFtZSI6IkpvaG4gTHlkZW4uanBnIiwiY29udGVudFR5cGUiOiJpbWFnZS9qcGVnIiwiY29udGVudExlbmd0aCI6MTM0Nzl9LCJzM09iamVjdEtleSI6Ii8vcHVibGljX0pvaG4gTHlkZW4uanBnXzEzNDc5IiwiaWF0IjoxNjk1NjU4MDA1fQ.40eiuZv9eA8p4YhkzaXk3vg272tzivxjIlJ4GasbTtQ",
      "phone": "+44 (0) 1294 833444",
      "email": "johnlyden@wilsonsauctions.com"
    }
  ],
  "withdrawn": false,
  "description": null,
  "loose_items": [
    {
      "created_date": "2026-06-10T07:41:13.000Z",
      "name": "V5C/VLC",
      "updated_date": "2026-06-10T07:41:13.000Z",
      "id": 337256,
      "type": "Disposal",
      "locked": true
    }
  ],
  "media": [
    {
      "meta_data": {
        "file_name": "asset-364095/GeneralImages-1_17815996359626979285140064911272.jpg",
        "content_length": 159028,
        "designation": "Front Angle",
        "category": "GeneralImages",
        "content_type": "image/jpeg"
      },
      "public_url": "https://assets.wilsonsauctions.com///lots_asset-364095%2FGeneralImages-1_17815996359626979285140064911272.jpg_159028/320x231.webp",
      "public_urls": [
        {
          "size": "320",
          "url": "https://assets.wilsonsauctions.com///lots_asset-364095%2FGeneralImages-1_17815996359626979285140064911272.jpg_159028/320x231.webp"
        },
        {
          "size": "600",
          "url": "https://assets.wilsonsauctions.com///lots_asset-364095%2FGeneralImages-1_17815996359626979285140064911272.jpg_159028/600x500.webp"
        },
        {
          "size": "1000",
          "url": "https://assets.wilsonsauctions.com///lots_asset-364095%2FGeneralImages-1_17815996359626979285140064911272.jpg_159028/1000x800.webp"
        },
        {
          "size": "1600",
          "url": "https://assets.wilsonsauctions.com///lots_asset-364095%2FGeneralImages-1_17815996359626979285140064911272.jpg_159028/1600x1067.webp"
        }
      ],
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXRhRGF0YSI6eyJmaWxlTmFtZSI6ImFzc2V0LTM2NDA5NS9HZW5lcmFsSW1hZ2VzLTFfMTc4MTU5OTYzNTk2MjY5NzkyODUxNDAwNjQ5MTEyNzIuanBnIiwiY29udGVudExlbmd0aCI6MTU5MDI4LCJjb250ZW50VHlwZSI6ImltYWdlL2pwZWciLCJkZXNpZ25hdGlvbiI6IkZyb250IEFuZ2xlIiwiY2F0ZWdvcnkiOiJHZW5lcmFsSW1hZ2VzIn0sInMzT2JqZWN0S2V5IjoiLy9sb3RzX2Fzc2V0LTM2NDA5NS9HZW5lcmFsSW1hZ2VzLTFfMTc4MTU5OTYzNTk2MjY5NzkyODUxNDAwNjQ5MTEyNzIuanBnXzE1OTAyOCIsImlhdCI6MTc4MTYwMDAzMX0.KFe2NEnTgh494DOMhN9f7ZV9mRlLMMqCzkyfO4Mav5M"
    }
  ],
  "video_urls": null,
  "branch": {
    "path_name": "glasgow",
    "address": {
      "iso_country_name": "United Kingdom",
      "city": "Dalry",
      "flat_number": "",
      "iso_country_code": "GB",
      "county": "Ayrshire",
      "postcode": "KA24 4LG",
      "property_name": "Wilsons Auctions",
      "street": "Kilwinning Road",
      "line3": "",
      "line2": "",
      "line1": "6 Kilwinning Road",
      "lat_lng": "(55.694211, -4.710252)",
      "property_number": "6"
    },
    "contact_email": "scotland@wilsonsauctions.com",
    "name": "Glasgow",
    "is_storage_facility": false,
    "telephone": "+44 (0) 1294 833444",
    "id": 3,
    "region": {
      "name": "United Kingdom",
      "currency": "GBP",
      "id": "GB"
    },
    "business_working_hours": {
      "monday": "9am - 5pm",
      "thursday": "9am - 5pm",
      "friday": "9am - 5pm",
      "sunday": "Closed",
      "wednesday": "9am - 5pm",
      "tuesday": "9am - 5pm",
      "saturday": "Closed"
    },
    "map_location": {
      "zoom_level": 14,
      "lng": -4.71025,
      "lat": 55.694211
    }
  },
  "location_branch": {
    "path_name": "glasgow",
    "address": {
      "iso_country_name": "United Kingdom",
      "city": "Dalry",
      "flat_number": "",
      "iso_country_code": "GB",
      "county": "Ayrshire",
      "postcode": "KA24 4LG",
      "property_name": "Wilsons Auctions",
      "street": "Kilwinning Road",
      "line3": "",
      "line2": "",
      "line1": "6 Kilwinning Road",
      "lat_lng": "(55.694211, -4.710252)",
      "property_number": "6"
    },
    "contact_email": "scotland@wilsonsauctions.com",
    "name": "Glasgow",
    "is_storage_facility": false,
    "telephone": "+44 (0) 1294 833444",
    "id": 3,
    "region": {
      "name": "United Kingdom",
      "currency": "GBP",
      "id": "GB"
    },
    "business_working_hours": {
      "monday": "9am - 5pm",
      "thursday": "9am - 5pm",
      "friday": "9am - 5pm",
      "sunday": "Closed",
      "wednesday": "9am - 5pm",
      "tuesday": "9am - 5pm",
      "saturday": "Closed"
    },
    "map_location": {
      "lng": -4.71025,
      "lat": 55.694211
    }
  },
  "out_of_auction": false,
  "reg_number": "ST67FRU",
  "asset_id": 364095,
  "vendor": {
    "publish_client_name_on_catalogue": false,
    "vendor_logo_token": null,
    "publish_client_logo": false,
    "marketing_name_override": null,
    "id": 4402,
    "vendor_name": ""
  },
  "lot_location_text": "Glasgow",
  "supress_asset_location": null,
  "details": null,
  "is_featured": false,
  "item_class": "car",
  "no_reserve": false,
  "location_off_site": false,
  "marketing_category_ids": [],
  "delivery_only": null,
  "hide_asset_location": null,
  "vehicle_details": {
    "body_type": "Hatchback",
    "mot_location": null,
    "master_key": true,
    "fuel": "Petrol",
    "three_sixty_walk_around": null,
    "updated_date": "2026-06-19T09:01:51.000Z",
    "wheelchair_accessible_vehicle": false,
    "mot": "2025-12-02",
    "transmission": "Manual",
    "nama_web_external_access": true,
    "registration_date": "2017-11-13T00:00:00.000Z",
    "cod_certificate_id": null,
    "model": "KA+ Zetec",
    "vin": "MAJUXXMTKUHM00519",
    "id": 107756,
    "current_valuation": {
      "average": 4025,
      "valuation_date": "2026-05-31T23:00:00.000Z",
      "below": 3400,
      "id": 553323,
      "cap_overridden": false,
      "clean": 4650,
      "cap_id": "75583",
      "retail": 6350
    },
    "gears": 5,
    "mileage": 40680,
    "service_history": true,
    "num_keys": null,
    "one_link_vehicle_id": null,
    "cap_id": "75583",
    "vin_checked_status": "VIN Matching",
    "doors": 5,
    "engine_size": 1198,
    "wilsons_assured_external_access": false,
    "finance_records": null,
    "former_keepers": 4,
    "nova_certificate_status": null,
    "damage_costing": "554.00",
    "salvageable_total_loss_note": null,
    "reg_plate_history": [],
    "co2": 114,
    "sale_type": "Standard",
    "dealer_auctions_upload_status": null,
    "updated_by_user_id": null,
    "v5_id": "461476721903",
    "residual_value": 0,
    "salvageable_total_loss": null,
    "reg_number": "ST67FRU",
    "numof_services": 4,
    "is_running": true,
    "make": "Ford",
    "manufactured": "2017-11-13T00:00:00.000Z",
    "dealer_auctions_id": null,
    "nova_code": null,
    "mileage_units": "Miles",
    "created_by_user_id": null,
    "warning_messages": null,
    "is_not_running": false,
    "prev_reg": null,
    "is_roi_reg": false,
    "cap_valuations": [
      {
        "average": 4025,
        "valuation_date": "2026-05-31T23:00:00.000Z",
        "below": 3400,
        "id": 553323,
        "cap_overridden": false,
        "clean": 4650,
        "cap_id": "75583",
        "retail": 6350
      },
      {
        "average": 4025,
        "valuation_date": "2026-04-30T23:00:00.000Z",
        "below": 3400,
        "id": 553324,
        "cap_overridden": false,
        "clean": 4650,
        "cap_id": "75583",
        "retail": 6350
      },
      {
        "average": 4025,
        "valuation_date": "2026-03-31T23:00:00.000Z",
        "below": 3400,
        "id": 553325,
        "cap_overridden": false,
        "clean": 4650,
        "cap_id": "75583",
        "retail": 6350
      }
    ],
    "colour": "Gold",
    "created_date": "2026-06-09T13:25:22.000Z",
    "import_id": null,
    "nama_grade": "3",
    "service_history_location": "Here",
    "aircon": null,
    "v5_location": "Here",
    "has_wilsons_assured": false,
    "category": null,
    "mileage_checked": "Correct",
    "remarks": null,
    "seating_capacity": 5
  },
  "lot_status": "Awaiting Auction",
  "published_at": "2026-06-19T12:30:11+01:00",
  "tax_designation": "Margin",
  "name": "Ford KA+ Zetec 1198cc",
  "ended": false,
  "lot_location_filter_text": "Glasgow",
  "estimated_price_range": {
    "lower_estimation": 4650
  },
  "designation": "Vehicle",
  "category": "Vehicle",
  "has_documents": false,
  "lot_bidding_status": {
    "total_bids": 15,
    "starting_bid": 300,
    "lot_id": 388604,
    "current_bid": {
      "amount": 2450,
      "made_by_user_id": "6cd4a183-250c-4e30-9d0a-4697a5808539",
      "lot_id": 388604
    },
    "increment": 50,
    "time_remaining": 178082,
    "in_extension": false,
    "ended": 0,
    "end_date_string": "2026-06-22T11:35:00.000Z",
    "suspended": false,
    "withdrawn": false,
    "extension_reason": "",
    "extension_amount": 0,
    "lot_status": "Awaiting Auction",
    "auction_id": 4551,
    "on_hold_end_date_string": "",
    "invoice_hammer_price": 0
  },
  "is_favoured": null,
  "markers": {
    "entry": {
      "mileage_check": {
        "marked": true,
        "overridden": false,
        "marker_type": "MileageCheck",
        "manually_adjusted": false,
        "id": 836419,
        "marker_set": "Entry",
        "resolved": false
      },
      "missing_v5": {
        "marked": true,
        "overridden": false,
        "marker_type": "MissingV5",
        "manually_adjusted": false,
        "id": 836420,
        "marker_set": "Entry",
        "resolved": false
      }
    },
    "exit": {
      "mileage_check": {
        "marked": true,
        "overridden": false,
        "marker_type": "MileageCheck",
        "manually_adjusted": false,
        "id": 836421,
        "marker_set": "Exit",
        "resolved": false
      },
      "missing_v5": {
        "marked": true,
        "overridden": false,
        "marker_type": "MissingV5",
        "manually_adjusted": false,
        "id": 836422,
        "marker_set": "Exit",
        "resolved": false
      }
    }
  },
  "from_url": "https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"
}
```

Each scraped lot returns a rich record with 40+ fields:

#### Lot Identity & Status

| Field | Meaning | Use Case |
|---|---|---|
| `Asset ID` | Unique system identifier for the lot | Primary key for database ingestion |
| `Name` | Display name of the lot (e.g., vehicle VIN or asset description) | Human-readable lot title |
| `Lot Status` | Current status (active, ended, withdrawn) | Filter for live vs. closed auctions |
| `Lot Bidding Status` | Bidding state (open, closed, reserved) | Understand auction activity |
| `Withdrawn` | Boolean flag if lot was pulled from auction | Identify cancelled items |
| `Published At` | Timestamp when lot was listed | Track listing freshness |
| `Ended` | Boolean or timestamp indicating auction closure | Determine sale status |

#### Auction Schedule

| Field | Meaning | Use Case |
|---|---|---|
| `Current Auction` | Active auction batch or sale event ID | Group lots by sale cycle |
| `End Date` | Scheduled auction closing time | Plan bidding windows |

#### Asset Details & Classification

| Field | Meaning | Use Case |
|---|---|---|
| `Item Class` | Category (e.g., "car", "equipment") | Segment data by asset type |
| `Category` | Subcategory for the lot (e.g., "sedan", "truck") | Granular classification |
| `Designation` | Legal or regulatory designation | Compliance and documentation |
| `Description` | Full text description of the lot condition, specs, and features | Detailed asset information |
| `Details` | Structured field for additional specifications | Machine-readable attributes |

#### Vehicle-Specific Data

| Field | Meaning | Use Case |
|---|---|---|
| `Vehicle Details` | Make, model, year, mileage, condition, transmission, fuel type | Used car market analysis |
| `Registration Number` | Vehicle plate/registration (if available) | Verification and history checks |

#### Location & Logistics

| Field | Meaning | Use Case |
|---|---|---|
| `Branch` | Wilson Auctions branch managing the sale | Identify auction location |
| `Location Branch` | Branch name and region | Buyer logistics planning |
| `Lot Location Text` | On-site or off-site storage description | Shipping/pickup arrangements |
| `Lot Location Filter Text` | Searchable location filter text | Geospatial query support |
| `Location Off Site` | Boolean indicating off-site storage | Identify remote lots |
| `Suppress Asset Location` | Boolean to hide exact location for sensitivity | Privacy/security flag |
| `Hide Asset Location` | Alternative flag for location masking | Confidentiality option |

#### Pricing & Valuation

| Field | Meaning | Use Case |
|---|---|---|
| `Estimated Price Range` | Predicted sale price band (e.g., "$5,000–$7,500") | Bid guidance and valuation |
| `No Reserve` | Boolean indicating lot has no minimum bid | Bidding strategy |

#### Seller & Vendor Information

| Field | Meaning | Use Case |
|---|---|---|
| `Vendor` | Seller or asset owner name | Contact and relationship tracking |
| `Points Of Contact` | Vendor contact details (phone, email) | Communication for inquiries |

#### Featured & Marketing

| Field | Meaning | Use Case |
|---|---|---|
| `Is Featured` | Boolean if lot has premium placement | Prioritize high-visibility items |
| `Is Favoured` | Boolean if lot is user-favorited | Identify popular lots |
| `Marketing Category IDs` | Categories used for promotion | Marketing analytics |

#### Documentation & Media

| Field | Meaning | Use Case |
|---|---|---|
| `Media` | Embedded images and photo count | Visual asset inventory |
| `Video URLs` | Links to video previews | Multimedia content extraction |
| `Has Documents` | Boolean indicating PDFs or reports available | Document availability flag |
| `Appraisal Report Configuration` | Settings for professional valuations | Valuation methodology |

#### Special Conditions

| Field | Meaning | Use Case |
|---|---|---|
| `Delivery Only` | Lot can only be delivered, not picked up | Logistics constraint |
| `Out Of Auction` | Not currently accepting bids | Inactive lot marker |
| `Tax Designation` | Tax classification or exemption | Regulatory compliance |
| `Class Details Field Specification` | Schema metadata for the class | Technical integration |
| `Markers` | Custom tags or labels | Custom filtering and organization |

***

### How to Use

1. **Identify target search URLs** — Visit Wilson Auctions, apply filters (class, category, price, location), and copy the resulting URL.
2. **Extract filter parameters** — Note the query string (e.g., `fs_class=%5B%22car%22%5D`). You can adjust page numbers with `&fs_page=`.
3. **Build the input JSON** — Paste URLs into the `urls` array. Set `max_items_per_url` to control scope (20–200 typical).
4. **Enable error tolerance** — Set `ignore_url_failures: true` to prevent interruptions in bulk runs.
5. **Run the scraper** — Initiate the actor and monitor the log for completion.
6. **Download and process** — Export results as JSON or CSV for analysis, import into Excel or databases.

**Best practices:**

- Use smaller `max_items_per_url` values (20–50) for initial test runs.
- Break large requests into multiple scraper runs by page or filter to avoid timeouts.
- Set `ignore_url_failures: true` when scraping multiple URLs to ensure fault tolerance.

***

### Use Cases & Business Value

- **Price intelligence:** Track market values for vehicles, equipment, and real estate across regions.
- **Competitive monitoring:** Monitor competitor inventory and pricing strategies in real time.
- **Trend analysis:** Identify seasonal patterns, category performance, and demand shifts.
- **Dealer inventory management:** Sync auction data with internal systems for sourcing and valuation.
- **Academic research:** Build historical datasets for economics, market behavior, or logistics studies.
- **Algorithmic bidding:** Feed structured lot data into bidding models and decision support systems.

The scraper transforms hours of manual browsing into minutes of automated data collection, enabling faster decision-making and deeper market insights.

***

### Conclusion

The **Wilson Auctions Lots Scraper** is a powerful tool for anyone needing structured auction data at scale. Whether you're a dealer tracking inventory, a researcher analyzing market trends, or a platform integrating auction feeds, this scraper delivers clean, comprehensive records across 40+ fields. Start collecting actionable auction intelligence today.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the lots search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "urls": [
        "https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/wilsonsauctions-lots-search-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 = {
    "urls": ["https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/wilsonsauctions-lots-search-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.wilsonsauctions.com/lots?fs_class=%5B%22car%22%5D&fs_page=5#lots"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/wilsonsauctions-lots-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/wilsonsauctions-lots-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Wilsonsauctions Lots Search Scraper",
        "description": "Scrape detailed auction lots from Wilson Auctions with precision. This tool collects titles, descriptions, estimated prices, bidding status, vehicle details, and 40+ fields per lot — perfect for auction analysts, dealers, and market researchers.",
        "version": "0.0",
        "x-build-id": "fPCSsC2j6aBaZMIC9"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~wilsonsauctions-lots-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-wilsonsauctions-lots-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/stealth_mode~wilsonsauctions-lots-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-wilsonsauctions-lots-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/stealth_mode~wilsonsauctions-lots-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-wilsonsauctions-lots-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the lots search list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the lots search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```