{ "openapi": "3.0.1", "info": { "title": "Mecum Auctions Scraper", "description": "Mecum Auctions results and upcoming lots: 312,000+ collector cars, motorcycles, tractors and road art since 2012, with sold price or high bid, make, model, year, specs and all photos. Filter by make, model, year, auction, price. VIN, mileage and highlights as an add-on.", "version": "1.0", "x-build-id": "TSxQcxd38T6Yya0Kf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~mecum-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-mecum-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/normdata~mecum-scraper/runs": { "post": { "operationId": "runs-sync-normdata-mecum-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/normdata~mecum-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-mecum-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": { "maxItems": { "title": "Maximum lots", "minimum": 1, "type": "integer", "description": "Stop after this many lots in total. Leave empty for no limit (every matching lot). The Apify Free plan is always capped at 10." }, "status": { "title": "What to scrape", "enum": [ "past", "upcoming" ], "type": "string", "description": "Past auctions are every Mecum auction since 2012 (312,000+ lots) with the sold price or the high bid. Upcoming auctions are the lots already published for the auctions to come." }, "results": { "title": "Results (past auctions)", "enum": [ "sold", "unsold", "all" ], "type": "string", "description": "Sold lots, unsold lots (Mecum's \"The Bid Goes On\": not sold on the block, with the highest bid), or both." }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Words of the lot title or specs, e.g. \"boss 429\", \"split window\", \"hemi cuda\", \"gt350\", \"neon sign\". A lot must contain every word of a term (case doesn't matter, no typo matching). Several terms: a lot matching ANY of them is kept.", "items": { "type": "string" } }, "urls": { "title": "...or paste mecum.com links", "type": "array", "description": "Lot pages (mecum.com/lots/...) or auction pages (mecum.com/auctions/..., every lot of the auction). The filters are ignored with links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "lotTypes": { "title": "Lot type", "type": "array", "description": "Keep only these kinds of lots.", "items": { "type": "string", "enum": [ "Auto", "Road Art", "Motorcycle", "Tractor", "Other", "Boat", "Guitar", "Engine", "Trailer", "Airplane" ], "enumTitles": [ "Auto (194,268 lots)", "Road Art (79,477 lots)", "Motorcycle (24,201 lots)", "Tractor (11,311 lots)", "Other (2,000 lots)", "Boat (313 lots)", "Guitar (256 lots)", "Engine (233 lots)", "Trailer (129 lots)", "Airplane (1 lots)" ] } }, "makes": { "title": "Make", "type": "array", "description": "Keep only these makes, Mecum's names, e.g. \"Chevrolet\", \"Ford\", \"Porsche\", \"Mercedes-Benz\", \"Harley-Davidson\", \"John Deere\". Case doesn't matter. A make Mecum never had shows a warning in the log.", "items": { "type": "string" } }, "models": { "title": "Model", "type": "array", "description": "Keep only these models, e.g. \"Corvette\", \"Mustang\", \"Camaro\", \"911\", \"Bronco\". Combine with Make to avoid other brands' models of the same name.", "items": { "type": "string" } }, "yearFrom": { "title": "Model year from", "minimum": 0, "type": "integer", "description": "Keep vehicles (or items) from this model year on, e.g. 1960." }, "yearTo": { "title": "Model year to", "minimum": 0, "type": "integer", "description": "Keep vehicles up to this model year, e.g. 1972." }, "bodyStyles": { "title": "Body style", "type": "array", "description": "Keep only these body styles. Mecum records it on about half of the cars.", "items": { "type": "string", "enum": [ "Convertible", "Pickup", "Coupe", "Fastback", "Roadster", "Sedan", "Hardtop", "Resto Mod", "SUV", "Street Rod", "Reproduction", "Wagon", "Cabriolet", "Pace Car Edition", "Custom", "Split Window Coupe", "Limousine", "Van", "Bubble Top", "Pro Touring", "Bus", "Station Wagon", "2-Door Hardtop", "Pedal Tractor", "Skyliner", "Sunliner", "Spider", "Race Car", "Truck", "Collector Edition", "Phaeton", "Hot Rod", "Pro Street", "Hatchback", "Spyder", "Replica", "40th Anniversary", "Convertible Coupe", "Golf Cart", "Targa", "Speedster", "Touring", "Convertible Sedan", "Electric Guitar", "35th Anniversary", "Roadster Pickup", "Diesel", "50th Anniversary", "Racer", "Restored", "Silver Anniversary", "Trailer", "Motorcycle", "NASCAR", "Sport Coupe", "With Sidecar" ], "enumTitles": [ "Convertible (38,587 lots)", "Pickup (20,290 lots)", "Coupe (16,144 lots)", "Fastback (3,848 lots)", "Roadster (3,652 lots)", "Sedan (3,378 lots)", "Hardtop (2,599 lots)", "Resto Mod (2,206 lots)", "SUV (2,006 lots)", "Street Rod (1,810 lots)", "Reproduction (1,671 lots)", "Wagon (1,278 lots)", "Cabriolet (929 lots)", "Pace Car Edition (762 lots)", "Custom (682 lots)", "Split Window Coupe (561 lots)", "Limousine (341 lots)", "Van (338 lots)", "Bubble Top (328 lots)", "Pro Touring (286 lots)", "Bus (276 lots)", "Station Wagon (273 lots)", "2-Door Hardtop (272 lots)", "Pedal Tractor (265 lots)", "Skyliner (265 lots)", "Sunliner (255 lots)", "Spider (253 lots)", "Race Car (251 lots)", "Truck (230 lots)", "Collector Edition (205 lots)", "Phaeton (186 lots)", "Hot Rod (182 lots)", "Pro Street (182 lots)", "Hatchback (159 lots)", "Spyder (157 lots)", "Replica (143 lots)", "40th Anniversary (135 lots)", "Convertible Coupe (134 lots)", "Golf Cart (129 lots)", "Targa (129 lots)", "Speedster (126 lots)", "Touring (122 lots)", "Convertible Sedan (121 lots)", "Electric Guitar (119 lots)", "35th Anniversary (117 lots)", "Roadster Pickup (115 lots)", "Diesel (113 lots)", "50th Anniversary (111 lots)", "Racer (109 lots)", "Restored (109 lots)", "Silver Anniversary (106 lots)", "Trailer (106 lots)", "Motorcycle (104 lots)", "NASCAR (104 lots)", "Sport Coupe (104 lots)", "With Sidecar (103 lots)" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Keep only these transmissions. Mecum records it on most lots from 2023 on, so this filter keeps mostly recent auctions.", "items": { "type": "string", "enum": [ "Automatic", "Manual", "Semi-Automatic" ], "enumTitles": [ "Automatic (39,600 lots)", "Manual (28,548 lots)", "Semi-Automatic (117 lots)" ] } }, "engines": { "title": "Engine", "type": "array", "description": "Keep only these engine layouts. Mecum records it on most lots from 2023 on, so this filter keeps mostly recent auctions.", "items": { "type": "string", "enum": [ "V-8", "Inline 6-cylinder", "Inline 4-cylinder", "V-6", "V-12", "V-10", "Inline 8-cylinder" ], "enumTitles": [ "V-8 (40,678 lots)", "Inline 6-cylinder (3,125 lots)", "Inline 4-cylinder (3,090 lots)", "V-6 (2,665 lots)", "V-12 (708 lots)", "V-10 (416 lots)", "Inline 8-cylinder (294 lots)" ] } }, "exteriorColors": { "title": "Exterior color", "type": "array", "description": "Keep only these color families (the exact paint name is in the results). Mecum records it on most lots from 2023 on, so this filter keeps mostly recent auctions.", "items": { "type": "string", "enum": [ "Red", "Black", "Blue", "White", "Silver", "Green", "Yellow", "Orange", "Gray", "Gold", "Burgundy", "Tan", "Maroon", "Brown", "Purple", "Teal", "Multicolor", "Pink" ], "enumTitles": [ "Red (7,529 lots)", "Black (6,556 lots)", "Blue (5,190 lots)", "White (4,753 lots)", "Silver (2,666 lots)", "Green (2,408 lots)", "Yellow (1,814 lots)", "Orange (1,571 lots)", "Gray (1,563 lots)", "Gold (756 lots)", "Burgundy (678 lots)", "Tan (509 lots)", "Maroon (502 lots)", "Brown (454 lots)", "Purple (374 lots)", "Teal (372 lots)", "Multicolor (309 lots)", "Pink (132 lots)" ] } }, "interiorColors": { "title": "Interior color", "type": "array", "description": "Keep only these interior color families. Mecum records it on most lots from 2023 on, so this filter keeps mostly recent auctions.", "items": { "type": "string", "enum": [ "Black", "Tan", "Red", "Gray", "Blue", "White", "Brown", "Green", "Burgundy", "Silver", "Gold", "Orange", "Teal" ], "enumTitles": [ "Black (13,171 lots)", "Tan (4,701 lots)", "Red (3,627 lots)", "Gray (3,474 lots)", "Blue (1,963 lots)", "White (1,805 lots)", "Brown (1,132 lots)", "Green (541 lots)", "Burgundy (367 lots)", "Silver (186 lots)", "Gold (155 lots)", "Orange (149 lots)", "Teal (126 lots)" ] } }, "auctions": { "title": "Auction", "type": "array", "description": "Keep only these auctions, by name: \"Kissimmee\" (every Kissimmee auction), \"Monterey 2025\", \"Indy\", \"Las Vegas Motorcycles\", \"Gone Farmin'\". Every word must match the auction name.", "items": { "type": "string" } }, "dateFrom": { "title": "Auction date from", "type": "string", "description": "Keep lots that crossed (or will cross) the block on or after this day. A date like \"2024-01-01\", or a period like \"6 months\" or \"2 years\"." }, "dateTo": { "title": "Auction date to", "type": "string", "description": "Same format as \"Auction date from\", e.g. \"2024-12-31\"." }, "labels": { "title": "Lot labels", "type": "array", "description": "Keep only lots with ANY of these Mecum labels, e.g. \"No reserve\" (sold to the highest bidder whatever the price).", "items": { "type": "string", "enum": [ "No reserve", "Feature", "Main attraction", "Charity" ], "enumTitles": [ "No reserve (113,834 lots)", "Feature (54,742 lots)", "Main attraction (4,099 lots)", "Charity (359 lots)" ] } }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Sold price (or high bid for unsold lots) at least this." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Sold price (or high bid for unsold lots) at most this." }, "titleExcludes": { "title": "Must not contain", "type": "array", "description": "Drop lots whose title or specs contain any of these words, e.g. \"replica\", \"tribute\", \"clone\", \"sign\", \"pedal car\".", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "recent", "oldest", "price_high", "price_low", "year_new", "year_old" ], "type": "string", "description": "Order of the results. Matters most when you set a Maximum. Price and model year sorts leave out lots with no price (or no year)." }, "includeDetails": { "title": "Full lot details", "type": "boolean", "description": "Add the lot page to every lot: VIN or serial number, odometer reading, engine and frame numbers, the full engine spec, title type, the highlights list, equipment list, conditions of sale, the lot story, walkaround video and, for recent and upcoming auctions, the venue, city and state. Charged as an add-on per lot." }, "onlyNew": { "title": "New lots only", "type": "boolean", "description": "For scheduled runs: save only lots this same search has not saved before. The first run saves everything; later runs save just what is new. Kept per search (terms, links and filters)." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Give \"New lots only\" a fixed name to keep its memory even after you change the filters." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }