{ "openapi": "3.0.1", "info": { "title": "Pisos.com Scraper", "description": "Scrape Spanish property listings from pisos.com. Use filters (sale/rent, type, location, price, bedrooms) or paste a search URL — the URL wins when set. Returns price, size, rooms, location, phone, and photos.", "version": "0.1", "x-build-id": "V8bYouKaijjLXpTe1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~pisos-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-pisos-com-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/dadhalfdev~pisos-com-scraper/runs": { "post": { "operationId": "runs-sync-dadhalfdev-pisos-com-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/dadhalfdev~pisos-com-scraper/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-pisos-com-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": { "input_url": { "title": "Input URL", "type": "string", "description": "Optional. Paste any pisos.com search results URL to override the filters below. Must be left empty to use location and other structured filters (better for AI agents). If this field is filled, location/price/etc. are ignored." }, "listing_type": { "title": "Listing type", "enum": [ "venta", "alquiler", "obra_nueva" ], "type": "string", "description": "Buy (venta), rent (alquiler), or new-build promotions (obra nueva). Ignored when input_url is set.", "default": "venta" }, "property_type": { "title": "Property type", "enum": [ "pisos", "casas", "aticos", "duplex", "estudios", "lofts", "locales", "naves", "terrenos", "garajes" ], "type": "string", "description": "Property category on pisos.com. Ignored for obra nueva and when input_url is set.", "default": "pisos" }, "location": { "title": "Location", "type": "string", "description": "City, province, district, or area name as on pisos.com (e.g. madrid, barcelona, marbella, chamberí). Resolved via the site geo suggest. Ignored when input_url is set.", "default": "madrid" }, "price_min": { "title": "Minimum price (€)", "minimum": 0, "type": "integer", "description": "Minimum price in euros. Ignored when input_url is set." }, "price_max": { "title": "Maximum price (€)", "minimum": 0, "type": "integer", "description": "Maximum price in euros. Ignored when input_url is set." }, "bedrooms": { "title": "Minimum bedrooms", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Minimum number of bedrooms (habitaciones). Ignored when input_url is set.", "default": "" }, "bathrooms": { "title": "Minimum bathrooms", "enum": [ "", "1", "2", "3" ], "type": "string", "description": "Minimum number of bathrooms. Ignored when input_url is set.", "default": "" }, "area_min": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum floor area in m² (site steps: 40, 60, 80, …). Ignored when input_url is set." }, "area_max": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum floor area in m². Ignored when input_url is set." }, "sort_by": { "title": "Sort by", "enum": [ "", "fecharecientedesde-desc", "asc", "desc", "hab-desc", "hab-asc", "m2-desc", "m2-asc" ], "type": "string", "description": "Result order (same slugs as on pisos.com). Ignored when input_url is set.", "default": "" }, "max_properties": { "title": "Maximum number of properties", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many property listings to return (1–1000).", "default": 50 } } }, "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 } } } } } } } } } }