{ "openapi": "3.0.1", "info": { "title": "Spain Bank-Owned Properties (Pisos de Banco) Scraper", "description": "Scrape bank-owned homes, garages, land and commercial properties for sale in Spain from Solvia (Sabadell) and Aliseda (Santander) into one unified dataset with price, previous price, discount %, m², rooms and location.", "version": "0.1", "x-build-id": "kvRh4UGlf7mdiOHJB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sn41lz~spain-bank-properties/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sn41lz-spain-bank-properties", "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/sn41lz~spain-bank-properties/runs": { "post": { "operationId": "runs-sync-sn41lz-spain-bank-properties", "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/sn41lz~spain-bank-properties/run-sync": { "post": { "operationId": "run-sync-sn41lz-spain-bank-properties", "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": "Sources", "type": "array", "description": "Which bank property portals to scrape.", "items": { "type": "string", "enum": [ "solvia", "aliseda", "servihabitat" ], "enumTitles": [ "Solvia (Banco Sabadell)", "Aliseda (Banco Santander)", "Servihabitat (CaixaBank)" ] }, "default": [ "solvia", "aliseda", "servihabitat" ] }, "categories": { "title": "Property types", "type": "array", "description": "Types of property to scrape.", "items": { "type": "string", "enum": [ "viviendas", "garajes", "locales", "oficinas", "terrenos", "naves", "trasteros", "edificios" ], "enumTitles": [ "Homes (viviendas)", "Garages", "Retail units (locales)", "Offices", "Land (terrenos/suelos)", "Industrial (naves)", "Storage rooms (trasteros)", "Whole buildings" ] }, "default": [ "viviendas" ] }, "provinces": { "title": "Provinces (optional)", "type": "array", "description": "Only keep properties in these provinces, e.g. \"Madrid\", \"Valencia\", \"Alicante\". Leave empty for all of Spain.", "items": { "type": "string" } }, "onlyChanges": { "title": "Only new properties and price drops", "type": "boolean", "description": "Return only properties that are new or cheaper than in the previous run with the same settings, and pay only for those. The first run returns everything as new. Ideal for a daily schedule: you get alerts on new bank properties and price cuts.", "default": false }, "monitorName": { "title": "Monitor name (optional)", "type": "string", "description": "Only for 'Only new properties and price drops'. Runs with the same name share one history, e.g. 'madrid-deals'. Leave empty to keep one history per combination of settings." }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Only keep properties at or above this price." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Only keep properties at or below this price." }, "minDiscountPct": { "title": "Min discount (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only keep properties whose price has been reduced by at least this percentage." }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after saving this many properties. 0 = no limit.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed by default. Enable Apify Proxy only if your runs get blocked.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }