{ "openapi": "3.0.1", "info": { "title": "BOE Subastas Scraper + Catastro: Spanish Property Auctions", "description": "Spanish judicial, notarial and tax-agency property auctions from subastas.boe.es, one row per property, enriched with free Catastro data (built surface, year, use) and derived discount and price per m2. No login, no personal data.", "version": "0.1", "x-build-id": "oOs6SdpJTvwiSKKMI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/islandata~boe-subastas-catastro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-islandata-boe-subastas-catastro", "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/islandata~boe-subastas-catastro/runs": { "post": { "operationId": "runs-sync-islandata-boe-subastas-catastro", "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/islandata~boe-subastas-catastro/run-sync": { "post": { "operationId": "run-sync-islandata-boe-subastas-catastro", "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": { "provinces": { "title": "Provinces (INE codes)", "type": "array", "description": "Two-digit INE province codes, e.g. [\"38\"] Santa Cruz de Tenerife, [\"35\"] Las Palmas, [\"28\"] Madrid, [\"08\"] Barcelona. Use [\"all\"] for the whole of Spain (bounded by Max items). One province of 15-60 auctions takes 1-5 minutes at the polite rate of one request per second.", "default": [ "38" ], "items": { "type": "string" } }, "status": { "title": "Auction status", "enum": [ "EJ", "PU", "all" ], "type": "string", "description": "EJ = in progress (bidding open). PU = announced, not yet open. all = no status filter.", "default": "EJ" }, "propertyType": { "title": "Asset type", "enum": [ "I" ], "type": "string", "description": "I = real estate (default). Other BOE asset types (vehicles, others) are not validated in this version.", "default": "I" }, "maxItems": { "title": "Max items (rows)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many property rows. Each row is one paid 'result' event.", "default": 200 }, "enrichCatastro": { "title": "Enrich with Catastro", "type": "boolean", "description": "Query the free Catastro service for every cadastral reference found (built surface, year, use, map link). Adds one 'catastro-enrichment' event per enriched row.", "default": true }, "includeBids": { "title": "Include current maximum bid", "type": "boolean", "description": "Reads the 'Pujas' tab (one extra request per auction).", "default": true }, "includeAuthority": { "title": "Include managing authority", "type": "boolean", "description": "Court or agency running the auction: name, code, institutional address, phone and email (one extra request per auction).", "default": false }, "boeRequestsPerSecond": { "title": "BOE requests per second", "minimum": 1, "maximum": 2, "type": "integer", "description": "Politeness limit towards subastas.boe.es. 1 is the default and recommended value; maximum 2.", "default": 1 } } }, "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 } } } } } } } } } }