{ "openapi": "3.0.1", "info": { "title": "The Market Scraper: Classic Car Auction Prices, Bids & Alerts", "description": "Scrape The Market (themarket.co.uk) classic car auctions: live, upcoming and sold lots with current bid, bid count, reserve status, estimate, hammer and final price, mileage, chassis number, photos and description. Filter by make, year or price. Track new lots, bids and results.", "version": "0.1", "x-build-id": "bzNdZFIO57sXYR5MG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~themarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~themarket-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~themarket-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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": { "startUrls": { "title": "Lot, make or list links", "maxItems": 50, "type": "array", "description": "Optional public links from themarket.co.uk: a single lot page, a make page such as /auctions/ferrari, or the live, coming soon or results lists. When you add links, only those links are read and the auction status choice below is ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "lotStatus": { "title": "Auction status", "uniqueItems": true, "type": "array", "description": "Which lots to collect when no links are given. Live lots are open for bids, upcoming lots are listed before bidding opens, buy now lots are post-auction offers, and sold lots are finished auctions with their results.", "items": { "type": "string", "enum": [ "live", "upcoming", "buy_now", "sold" ], "enumTitles": [ "Live (open for bids)", "Upcoming (coming soon)", "Buy now offers", "Sold (results)" ] }, "default": [ "live", "upcoming", "sold" ] }, "make": { "title": "Make", "maxLength": 60, "type": "string", "description": "Keep only one make, written as on the site, for example Ferrari, Aston Martin or Mercedes-Benz. Leave empty for every make." }, "model": { "title": "Model contains", "maxLength": 80, "type": "string", "description": "Keep only models whose name contains this text, for example Testarossa or DB. Leave empty for every model." }, "yearFrom": { "title": "Year from", "minimum": 1880, "maximum": 2100, "type": "integer", "description": "Earliest model year to keep. Leave empty for no lower limit." }, "yearTo": { "title": "Year to", "minimum": 1880, "maximum": 2100, "type": "integer", "description": "Latest model year to keep. Leave empty for no upper limit." }, "minPrice": { "title": "Minimum price (GBP)", "minimum": 0, "maximum": 100000000, "type": "number", "description": "Keep lots whose current bid or sold price is at or above this amount. Lots with no bid yet are dropped when a minimum is set." }, "maxPrice": { "title": "Maximum price (GBP)", "minimum": 0, "maximum": 100000000, "type": "number", "description": "Keep lots whose current bid or sold price is at or below this amount. Leave empty for no maximum." }, "noReserveOnly": { "title": "No reserve only", "type": "boolean", "description": "Keep only lots that the site marks as no reserve.", "default": false }, "endingWithinHours": { "title": "Ending within (hours)", "minimum": 1, "maximum": 1440, "type": "integer", "description": "Keep only live lots whose auction ends within this many hours. Leave empty for no limit." }, "searchText": { "title": "Search words", "maxLength": 120, "type": "string", "description": "Words that must all appear in the lot title, tagline, registration or location, for example RHD manual. Matching happens in the Actor, not on the site." }, "summaryOnly": { "title": "List data only", "type": "boolean", "description": "Skip the individual lot pages. The run is faster and returns title, status, current bid or sold price, bid count, reserve status, end time and location. Estimates, description, vehicle facts, bid history and all page images need the lot pages.", "default": false }, "monitor": { "title": "Track changes between runs", "type": "boolean", "description": "Compares each lot with the previous run of the same monitor and labels it new lot, went live, bid increase, estimate change, ending soon, sold, withdrawn, status change or removed. Sold lots show hammer price against estimate.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name that keeps the history of one monitor. Use a different name for each set of links and filters you track.", "default": "default" }, "onlyChanges": { "title": "Only save changes", "type": "boolean", "description": "Save only lots that are new, changed or removed since the previous run. Unchanged lots are skipped and not charged.", "default": false }, "endingSoonHours": { "title": "Ending soon window (hours)", "minimum": 1, "maximum": 720, "type": "integer", "description": "A live lot counts as ending soon when its auction closes within this many hours. Used for the ending soon flag and monitor label.", "default": 24 }, "maxItems": { "title": "Maximum lots", "minimum": 1, "maximum": 6000, "type": "integer", "description": "Highest number of lots to save in this run. Free plans are limited to 25.", "default": 10 } } }, "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 } } } } } } } } } }