# 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

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

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

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

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

# README

## 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

Download the OpenAPI definition: https://api.apify.com/v2/acts/HaPShZFtKYP3llO1y/builds/fPCSsC2j6aBaZMIC9/openapi.json