# Pisos.com Real Estate Scraper (`automation-lab/pisos-com-real-estate-scraper`) Actor Scrape Pisos.com sale and rental listings for Spanish real-estate market research. Extract prices, locations, rooms, agencies, phones, images, and listing URLs. - **URL**: https://apify.com/automation-lab/pisos-com-real-estate-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.03 / 1,000 result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Pisos.com Real Estate Scraper 🏠πŸ‡ͺπŸ‡Έ Scrape Spanish real-estate listings from Pisos.com search result pages. Collect prices, locations, bedrooms, bathrooms, area, agency details, listing URLs, descriptions, and image URLs from public sale and rental pages. ### What does Pisos.com Real Estate Scraper do? Pisos.com Real Estate Scraper turns public Pisos.com search pages into structured datasets. Paste one or more Pisos.com result URLs and the actor extracts property cards from those pages. It works with sale and rental searches, including URLs you filtered directly on Pisos.com. Scrape public Pisos.com property listings for repeatable Spain market research. Extract structured fields such as price, location/address, property type, area, rooms/beds/baths, images, agency/agent data where available, and listing URLs. Export to JSON/CSV/Excel, schedule recurring runs, or call the actor through the Apify API. Best for PropTech teams, investors, brokerages, and researchers tracking Spain sale/rental supply, pricing, and listing changes. ### Who is it for? Real-estate investors use it to monitor asking prices and inventory in Spanish cities. Agencies use it to compare competing listings and track market supply. Analysts use it to build local housing datasets for dashboards and reports. Relocation teams use it to compare rentals across neighborhoods. Lead-generation teams use it to identify visible agencies and contact channels. ### Why use this actor? - 🏠 Scrapes public Pisos.com listing cards - πŸ‡ͺπŸ‡Έ Built for the Spanish real-estate market - πŸ”Ž Supports custom filtered search URLs - πŸ“Š Produces clean tabular data - ⚑ Uses fast HTTP extraction, not a browser - πŸ’Έ Pay per extracted listing ### What data can you extract? | Field | Description | | --- | --- | | `listingId` | Pisos.com listing identifier when present | | `url` | Absolute listing URL | | `title` | Listing title | | `operation` | Sale, rent, or new development when inferred | | `propertyType` | Piso, casa, dΓΊplex, chalet, etc. when inferred | | `price` | Numeric price | | `currency` | Usually EUR | | `priceText` | Original price text | | `location` | Full Pisos.com location subtitle | | `neighborhood` | Parsed neighborhood/area when available | | `city` | Parsed city/district when available | | `province` | Parsed province/city label when available | | `bedrooms` | Number of bedrooms | | `bathrooms` | Number of bathrooms | | `areaSqm` | Area in square meters | | `floor` | Floor text when visible | | `features` | Other visible features | | `description` | Search-card description snippet | | `agencyName` | Agency name inferred from public agency URL | | `agencyUrl` | Public agency page URL | | `agencyPhone` | Public phone number when embedded in the listing card | | `imageUrls` | Public image URLs from the search card | | `searchUrl` | Source search URL | | `pageNumber` | Result page number | | `scrapedAt` | ISO timestamp | ### How much does it cost to scrape Pisos.com listings? This actor uses pay-per-event pricing. You pay a $0.005 run-start fee plus a per-listing fee for each extracted result. | Apify plan tier | Price per listing | Approx. 1,000 listings | | --- | ---: | ---: | | FREE | $0.0000575 | $0.0575 | | BRONZE | $0.00005 | $0.05 | | SILVER | $0.000039 | $0.039 | | GOLD | $0.00003 | $0.03 | | PLATINUM | $0.00002 | $0.02 | | DIAMOND | $0.000014 | $0.014 | A small test run with 20 listings costs only a fraction of a cent plus the run-start fee. ### How to use it 1. Open Pisos.com in your browser. 2. Search for sale or rental properties. 3. Apply filters such as city, price, rooms, or property type. 4. Copy the resulting URL. 5. Paste it into `searchUrls`. 6. Set `maxItems`. 7. Run the actor. 8. Download the dataset as JSON, CSV, Excel, XML, or via API. ### Input example ```json { "searchUrls": [ "https://www.pisos.com/venta/pisos-madrid/" ], "maxItems": 50, "maxPagesPerSearch": 3, "includeImages": true, "maxRequestRetries": 3 } ```` ### Input fields #### `searchUrls` One or more Pisos.com search result URLs. Use the filters on Pisos.com first, then paste the resulting URLs. #### `maxItems` Maximum number of listings to save across all search URLs. #### `maxPagesPerSearch` Maximum number of paginated result pages to request for each search URL. Pisos.com uses page URLs such as `/2/` and `/3/`. #### `includeImages` When enabled, the actor includes public image URLs visible in the listing cards. #### `maxRequestRetries` Retry limit for transient request failures. ### Output example ```json { "listingId": "64171517859.528715", "url": "https://www.pisos.com/comprar/piso-goya28009-64171517859_528715/", "title": "Piso en calle de LombΓ­a, 5", "operation": "sale", "propertyType": "piso", "price": 589000, "currency": "EUR", "priceText": "589.000 €", "location": "Goya (Distrito Barrio de Salamanca. Madrid Capital)", "bedrooms": 2, "bathrooms": 1, "areaSqm": 48, "floor": "3Βͺ planta", "agencyName": "hernan inmobiliaria", "agencyUrl": "https://www.pisos.com/inmobiliaria-hernan_inmobiliaria/", "agencyPhone": "919374312", "searchUrl": "https://www.pisos.com/venta/pisos-madrid/", "pageNumber": 1, "scrapedAt": "2026-05-18T08:23:11.000Z" } ``` ### Tips for best results Use specific filtered URLs instead of broad country-wide searches. Start with a low `maxItems` value to validate your filters. Use multiple search URLs for different cities or operation types. Disable images if you only need prices and location fields. ### Common Pisos.com URLs - Sale listings: `https://www.pisos.com/venta/pisos-madrid/` - Rental listings: `https://www.pisos.com/alquiler/pisos-madrid/` - Valencia sale listings: `https://www.pisos.com/venta/pisos-valencia/` ### Integrations Connect the dataset to Google Sheets for market monitoring. Send results to a CRM for agency prospecting. Export CSV files into BI tools for price-per-square-meter analysis. Use Apify webhooks to trigger alerts when new runs finish. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/pisos-com-real-estate-scraper').call({ searchUrls: ['https://www.pisos.com/venta/pisos-madrid/'], maxItems: 50 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items.slice(0, 3)); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/pisos-com-real-estate-scraper').call(run_input={ 'searchUrls': ['https://www.pisos.com/venta/pisos-madrid/'], 'maxItems': 50, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items[:3]) ``` ### API usage with cURL ```bash curl "https://api.apify.com/v2/acts/automation-lab~pisos-com-real-estate-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"searchUrls":["https://www.pisos.com/venta/pisos-madrid/"],"maxItems":50}' ``` ### Use with MCP Use this actor from Claude Desktop, Claude Code, or other MCP clients through Apify MCP. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/pisos-com-real-estate-scraper ``` Example prompts: - "Scrape 50 sale listings from this Pisos.com Madrid URL and summarize median prices." - "Compare rentals from these two Pisos.com filtered URLs." - "Find listings with at least three bedrooms and export them as a table." ### Data quality notes Pisos.com search cards do not always include every field. Some listings may omit bathrooms, floor, phone, or images. The actor returns fields only when they are visible in the public HTML. ### Limitations The MVP focuses on search result pages. Full detail-page enrichment and exact coordinates may be added later if they remain cost-effective. The actor does not bypass logins, paywalls, or private user data. ### Legality This actor extracts publicly available listing information. You should review Pisos.com terms and ensure your use case complies with applicable laws, privacy rules, and platform policies. Do not use scraped data for spam, harassment, discrimination, or unlawful profiling. ### FAQ ### Why did I get fewer listings than requested? The search may have fewer visible results, duplicate listings may be removed, or `maxPagesPerSearch` may be too low. Increase `maxPagesPerSearch` or use broader filters. ### Why are some fields missing? Pisos.com does not show every attribute on every card. For example, some listings omit bathrooms, floor, agency phone, or image galleries. ### Build a production real-estate data workflow Use this actor as one source in a repeatable property-data pipeline: scrape listings from the source site, export structured JSON/CSV/Excel, schedule refreshes, and send results to your dashboard, CRM, warehouse, or AI/LLM workflow. Scrape public Pisos.com property listings for repeatable Spanish market research. Extract structured fields such as price, location/address, property type, area, rooms/beds/baths, images, agency/agent data where available, and listing URLs. Export to JSON/CSV/Excel, schedule recurring runs, or call the actor through the Apify API. Best for PropTech teams, investors, brokerages, and researchers tracking Spanish sale/rental supply, pricing, and listing changes. For broader coverage, combine it with related Automation Lab actors: - UK and Europe: [Rightmove Scraper](https://apify.com/automation-lab/rightmove-scraper), [ImmoScout24 Germany Real Estate Scraper](https://apify.com/automation-lab/immoscout24-de-scraper), [Imovirtual Scraper](https://apify.com/automation-lab/imovirtual-scraper), [RE/MAX Portugal Scraper](https://apify.com/automation-lab/remax-portugal-scraper), [Sreality.cz Real Estate Scraper](https://apify.com/automation-lab/sreality-cz-real-estate-scraper), [Pisos.com Real Estate Scraper](https://apify.com/automation-lab/pisos-com-real-estate-scraper) - US residential listings: [Zillow Scraper](https://apify.com/automation-lab/zillow-scraper), [Redfin Scraper](https://apify.com/automation-lab/redfin-scraper), [Realtor.com Scraper](https://apify.com/automation-lab/realtor-scraper) - Middle East / South Asia: [PropertyFinder Scraper](https://apify.com/automation-lab/propertyfinder-scraper), [Zameen Property Scraper](https://apify.com/automation-lab/zameen-property-scraper) ### Related scrapers - https://apify.com/automation-lab/idealista-scraper-api - https://apify.com/automation-lab/fotocasa-scraper - https://apify.com/automation-lab/zillow-scraper - https://apify.com/automation-lab/google-maps-lead-finder ### Support If you need a field that is visible on Pisos.com but missing from the dataset, open an issue with a sample URL and expected field. ### Changelog Initial version extracts public Pisos.com listing cards via HTTP with pagination support. # Actor input Schema ## `searchUrls` (type: `array`): Paste one or more Pisos.com search result URLs, for example sale or rental pages filtered on pisos.com. ## `maxItems` (type: `integer`): Maximum number of property listings to save across all search URLs. ## `maxPagesPerSearch` (type: `integer`): Pagination limit for each Pisos.com search URL. Pisos.com uses /2/, /3/ style page URLs. ## `includeImages` (type: `boolean`): Collect public listing image URLs visible in search result cards. ## `maxRequestRetries` (type: `integer`): Number of retry attempts for failed HTTP requests. ## Actor input object example ```json { "searchUrls": [ "https://www.pisos.com/venta/pisos-madrid/" ], "maxItems": 20, "maxPagesPerSearch": 1, "includeImages": true, "maxRequestRetries": 3 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [ "https://www.pisos.com/venta/pisos-madrid/" ], "maxItems": 20, "maxPagesPerSearch": 1, "includeImages": true, "maxRequestRetries": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/pisos-com-real-estate-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.pisos.com/venta/pisos-madrid/"], "maxItems": 20, "maxPagesPerSearch": 1, "includeImages": True, "maxRequestRetries": 3, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/pisos-com-real-estate-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [ "https://www.pisos.com/venta/pisos-madrid/" ], "maxItems": 20, "maxPagesPerSearch": 1, "includeImages": true, "maxRequestRetries": 3 }' | apify call automation-lab/pisos-com-real-estate-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/pisos-com-real-estate-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pisos.com Real Estate Scraper", "description": "Scrape Pisos.com sale and rental listings for Spanish real-estate market research. Extract prices, locations, rooms, agencies, phones, images, and listing URLs.", "version": "0.1", "x-build-id": "eKOfRBn7iGqXirpOr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~pisos-com-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-pisos-com-real-estate-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/automation-lab~pisos-com-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-pisos-com-real-estate-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/automation-lab~pisos-com-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-pisos-com-real-estate-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", "required": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Pisos.com search URLs", "type": "array", "description": "Paste one or more Pisos.com search result URLs, for example sale or rental pages filtered on pisos.com.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of property listings to save across all search URLs.", "default": 50 }, "maxPagesPerSearch": { "title": "Maximum pages per search URL", "minimum": 1, "maximum": 100, "type": "integer", "description": "Pagination limit for each Pisos.com search URL. Pisos.com uses /2/, /3/ style page URLs.", "default": 3 }, "includeImages": { "title": "Include image URLs", "type": "boolean", "description": "Collect public listing image URLs visible in search result cards.", "default": true }, "maxRequestRetries": { "title": "Max request retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of retry attempts for failed HTTP requests.", "default": 3 } } }, "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 } } } } } } } } } } ```