{ "openapi": "3.0.1", "info": { "title": "Pisos.com Scraper: Spain Real Estate & Rentals", "description": "Scrape Pisos.com: Spain property and real estate data. Flats, apartments and houses for rent or sale in any city or province. Price, price per m², price drops, size, rooms, coordinates, seller type. Detail mode adds energy certificate and small or large landlord. No private sellers' contacts.", "version": "0.1", "x-build-id": "eRkmR5lSZV9yFWwE2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/responsible_front_evw~pisos-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-responsible_front_evw-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/responsible_front_evw~pisos-com-scraper/runs": { "post": { "operationId": "runs-sync-responsible_front_evw-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/responsible_front_evw~pisos-com-scraper/run-sync": { "post": { "operationId": "run-sync-responsible_front_evw-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": { "startUrls": { "title": "Pisos.com search URLs", "type": "array", "description": "One or more results pages from pisos.com. Open pisos.com, choose rent or buy, the city or area and your filters, then paste the URL of the results page. Example: https://www.pisos.com/alquiler/pisos-valencia/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "city": { "title": "City or province (if you do not paste a URL)", "type": "string", "description": "Name in Spanish, for example valencia, madrid, sevilla, malaga, zaragoza. Used together with 'Operation'." }, "operation": { "title": "Operation", "enum": [ "alquiler", "venta" ], "type": "string", "description": "Rent or sale. Only used with 'City'.", "default": "alquiler" }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return in total. You only pay for the listings you get.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "0 = no limit. Each results page has 30 listings.", "default": 0 }, "fetchDetails": { "title": "Open each listing's detail page", "type": "boolean", "description": "Slower and charged extra (one more request per listing). Adds the full description, all features (lift, air conditioning, heating, orientation...), usable size, condition, energy certificate, last update date, agency name and whether the landlord is a small or large holder.", "default": false }, "includeAgencyContact": { "title": "Include agency phone", "type": "boolean", "description": "Only for listings published by real estate agencies. Contact data of private sellers is never collected.", "default": false }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 1, "type": "integer", "description": "Pause between page requests, to be gentle with the website.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Start with no proxy. If the website blocks the run, use Apify datacenter proxy. Residential proxy is rarely needed and costs much more.", "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 } } } } } } } } } }