{ "openapi": "3.0.1", "info": { "title": "BOE.es Subastas: Spanish Property Auction & Foreclosure Scraper", "description": "🇪🇸 Scrape subastas inmobiliarias de BOE.es: valoración, cargas y ref. catastral. 🏠 Get official Spanish property auction data, court details & 50/70% bidding limits. Search foreclosures and judicial auctions across Spain. Extrae ejecuciones hipotecarias y subastas judiciales fácilmente.", "version": "0.2", "x-build-id": "M03zJyQI6AEIGMNqg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalflow~spain-auction-scout/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalflow-spain-auction-scout", "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/signalflow~spain-auction-scout/runs": { "post": { "operationId": "runs-sync-signalflow-spain-auction-scout", "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/signalflow~spain-auction-scout/run-sync": { "post": { "operationId": "run-sync-signalflow-spain-auction-scout", "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", "required": [ "provincia", "tipoBien", "estado" ], "properties": { "provincia": { "title": "Province", "enum": [ "Todas las provincias", "Araba/Álava", "Albacete", "Alicante/Alacant", "Almería", "Ávila", "Badajoz", "Illes Balears", "Barcelona", "Burgos", "Cáceres", "Cádiz", "Castellón/Castelló", "Ciudad Real", "Córdoba", "A Coruña", "Cuenca", "Girona", "Granada", "Guadalajara", "Gipuzkoa", "Huelva", "Huesca", "Jaén", "León", "Lleida", "La Rioja", "Lugo", "Madrid", "Málaga", "Murcia", "Navarra", "Ourense", "Asturias", "Palencia", "Las Palmas", "Pontevedra", "Salamanca", "Santa Cruz de Tenerife", "Cantabria", "Segovia", "Sevilla", "Soria", "Tarragona", "Teruel", "Toledo", "Valencia/València", "Valladolid", "Bizkaia", "Zamora", "Zaragoza", "Ceuta", "Melilla" ], "type": "string", "description": "Province to search in. Select 'Todas las provincias' for all provinces.", "default": "Todas las provincias" }, "tipoBien": { "title": "Property Type", "enum": [ "Todos", "Vivienda", "Local comercial", "Garaje", "Trastero", "Nave industrial", "Solar", "Finca rústica", "Otros" ], "type": "string", "description": "Type of property. 'Todos' = Inmuebles, all subtypes (matches BOE 'Inmuebles, Todos').", "default": "Vivienda" }, "estado": { "title": "Auction Status", "enum": [ "Cualquiera", "Celebrándose", "Concluida", "Suspendida" ], "type": "string", "description": "Status of the auction. 'Cualquiera' = all statuses.", "default": "Cualquiera" }, "valorMinimo": { "title": "Minimum Value", "minimum": 0, "type": "integer", "description": "Minimum appraised value (EUR)." }, "valorMaximo": { "title": "Maximum Value", "minimum": 0, "type": "integer", "description": "Maximum appraised value (EUR)." }, "soloHacienda": { "title": "Only Tax Agency (AEAT)", "type": "boolean", "description": "If true, only show auctions from the Tax Agency.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of items to scrape. Set to 0 for no limit (all entries). Default 50.", "default": 50 }, "playwrightStorageStateKvsKey": { "title": "Playwright storage state (KVS key)", "type": "string", "description": "After logging in to subastas.boe.es in a local browser, export Playwright storage state JSON and upload it to this run's Key-Value Store under this record name (e.g. boe-storage.json). Enables session cookies for gated PDFs." }, "playwrightStorageStateJson": { "title": "Playwright storage state (inline JSON)", "type": "string", "description": "Optional alternative to KVS key: paste full Playwright storage_state JSON here. Prefer KVS for large/secrets. Only one of KVS key or inline should be set." }, "downloadDocumentsToKvs": { "title": "Download documents to Key-Value Store", "type": "boolean", "description": "If true, fetch each document URL with the same browser session (cookies) and save PDFs to the default Key-Value Store. Requires storage state for gated PDFs. Adds file_url / download_status per document.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }