{ "openapi": "3.0.1", "info": { "title": "UK Property Auction Lots: Allsop & Auction House UK", "description": "Every upcoming UK property auction lot in one clean feed: guide prices, full addresses and postcodes, tenure, yields, auction dates and links. Allsop plus the Auction House UK network, about 1,300 lots in under 30 seconds. Filter by postcode, price, bedrooms or keyword.", "version": "0.0", "x-build-id": "XDbuGqlE781v6vnCl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maloneydata~uk-property-auction-lots/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maloneydata-uk-property-auction-lots", "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/maloneydata~uk-property-auction-lots/runs": { "post": { "operationId": "runs-sync-maloneydata-uk-property-auction-lots", "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/maloneydata~uk-property-auction-lots/run-sync": { "post": { "operationId": "run-sync-maloneydata-uk-property-auction-lots", "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": { "sources": { "title": "Auctioneers", "type": "array", "description": "Which auctioneers to include. Allsop LLP, the Auction House UK network of regional auctioneers, Clive Emson (southern England) and Acuitus (commercial investments).", "items": { "type": "string", "enum": [ "allsop", "auctionhouse", "cliveemson", "acuitus" ], "enumTitles": [ "Allsop", "Auction House UK", "Clive Emson", "Acuitus (commercial)" ] }, "default": [ "allsop", "auctionhouse", "cliveemson", "acuitus" ] }, "postcodeAreas": { "title": "Postcode areas or districts", "type": "array", "description": "Only return lots in these areas. Letters only (\"G\", \"EH\", \"M\") match a whole postcode area; a full district (\"NW2\", \"G12\") matches just that district. Leave empty for the whole UK. Clive Emson publishes a town and coordinates rather than a postcode, so its lots are left out when this is set.", "default": [], "items": { "type": "string" } }, "minGuidePrice": { "title": "Minimum guide price (£)", "minimum": 0, "type": "integer", "description": "Compared with the lower guide figure. Lots without a guide price are left out when this is set." }, "maxGuidePrice": { "title": "Maximum guide price (£)", "minimum": 0, "type": "integer", "description": "Compared with the lower guide figure. Lots without a guide price are left out when this is set." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Only lots whose listing states at least this many bedrooms. Allsop rarely states bedroom counts, so this mostly applies to Auction House UK and Clive Emson." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep lots whose title, description or address contains any of these words, e.g. \"development\", \"HMO\", \"vacant\".", "default": [], "items": { "type": "string" } }, "includeResidential": { "title": "Include residential lots", "type": "boolean", "description": "Return houses, flats and other residential lots.", "default": true }, "includeCommercial": { "title": "Include commercial lots", "type": "boolean", "description": "Return shops, offices, land and other commercial lots.", "default": true }, "auctionHouseBranches": { "title": "Auction House UK branches", "type": "array", "description": "Limit Auction House UK to these regional branches, as they appear in the site's web addresses, e.g. \"london\", \"scotland\", \"northwest\", \"online\". Leave empty for all.", "default": [], "items": { "type": "string" } }, "includeAllsopHistory": { "title": "Include Allsop past lots", "type": "boolean", "description": "Also return Allsop's archive of past lots (tens of thousands, with outcomes such as Sold or Unsold). Use maxItems to control size.", "default": false }, "includePostAuctionLots": { "title": "Include lots still for sale after their auction", "type": "boolean", "description": "Also return Clive Emson and Acuitus lots that did not sell at auction but can still be bought.", "default": true }, "maxItems": { "title": "Maximum lots", "minimum": 1, "type": "integer", "description": "Stop after this many lots. You are charged per lot returned.", "default": 500 } } }, "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 } } } } } } } } } }