{ "openapi": "3.0.1", "info": { "title": "The Market Classic Car Auctions Scraper - Prices & Results", "description": "Scrape The Market (by Bonhams) classic car auctions: sold prices, top bids, bid counts, reserve status, make, model, year, plate, location and end dates. Add chassis, engine, mileage, estimates, full condition reports, key facts, video and bid history. 15 filters, only new lots.", "version": "1.0", "x-build-id": "zfReIgw5IvYGG1Slm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~themarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-themarket-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~themarket-scraper/runs": { "post": { "operationId": "runs-sync-normdata-themarket-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~themarket-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-themarket-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 results", "minimum": 1, "type": "integer", "description": "Stop after this many lots in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "statuses": { "title": "Status", "type": "array", "description": "Empty = every lot: past results (sold and not sold, sealed bids included), live auctions and coming soon.", "items": { "type": "string", "enum": [ "sold", "notSold", "live", "comingSoon" ], "enumTitles": [ "Sold", "Not sold (reserve not met)", "Live (bidding now)", "Coming soon" ] } }, "searchTerms": { "title": "Search words", "type": "array", "description": "Words to look for, like \"Porsche 911\" or \"Land Rover\". Uses the site search. Each one is a separate search.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "priceDesc", "priceAsc", "yearDesc", "yearAsc", "mostBids" ], "type": "string", "description": "Empty = end date, latest first. Prices are compared as shown, each lot in its own currency." }, "includeDetails": { "title": "Lot details (chassis, engine, mileage, estimates, condition reports, bid history)", "type": "boolean", "description": "Also read each lot page for its chassis number, engine, gearbox, fuel, colours, mileage, estimates, buyer fees, summary, specialist review and name, full write-up (background, exterior, interior, mechanical, history, verdict), key facts, video, main photos and every bid (amount and time). Charged per lot as an add-on." }, "makes": { "title": "Makes", "type": "array", "description": "Car makes, like Porsche or Land Rover. \"Mercedes\" also finds Mercedes-Benz.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Words in the model name, like 911 or Defender.", "items": { "type": "string" } }, "yearFrom": { "title": "Model year from", "minimum": 0, "type": "integer", "description": "Oldest model year." }, "yearTo": { "title": "Model year to", "minimum": 0, "type": "integer", "description": "Newest model year." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Sold price, or the top bid when not sold or still live, in the lot currency." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Sold price, or the top bid when not sold or still live, in the lot currency." }, "currencies": { "title": "Currencies", "type": "array", "description": "Keep only lots sold in these currencies.", "items": { "type": "string", "enum": [ "GBP", "EUR", "USD", "CHF" ], "enumTitles": [ "GBP", "EUR", "USD", "CHF" ] } }, "lotCountries": { "title": "Car located in", "type": "array", "description": "Where the car is, as 2-letter country codes, like GB, NL, US or FR.", "items": { "type": "string" } }, "steering": { "title": "Steering", "enum": [ "RHD", "LHD" ], "type": "string", "description": "Empty = both." }, "withoutReserveOnly": { "title": "Only without reserve", "type": "boolean", "description": "Keep only lots offered without reserve." }, "minBids": { "title": "Minimum bids", "minimum": 0, "type": "integer", "description": "Keep only lots with at least this many bids." }, "endDateFrom": { "title": "Auction end from", "type": "string", "description": "Keep only auctions ending on or after this date, like 2024-01-01 or \"1 year\" back from today." }, "endDateTo": { "title": "Auction end to", "type": "string", "description": "Keep only auctions ending on or before this date." }, "onlyNew": { "title": "Only new lots", "type": "boolean", "description": "Skip lots saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Lot pages (https://www.themarket.co.uk/listings/porsche/911/...), lists (https://www.themarket.co.uk/auctions/results, /auctions/live, /auctions/coming-soon, /auctions/sealed, /auctions/no-reserve), searches (/auctions/search-results?keywords=porsche) or make pages (/auctions/porsche).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }