# Idealista Property Scraper (`xtracto/idealista-property-scraper`) Actor Collect property listings from Idealista (Spain, Italy, Portugal) — price, location, rooms, size, floor, description, and listing agency — from any search URL. For sale or rent. - **URL**: https://apify.com/xtracto/idealista-property-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Idealista Property Scraper Collect property listings from **Idealista** (Spain, Italy, Portugal) — price, location, rooms, size, floor, description, and the listing agency — from any Idealista search you can build on the site. Works for sale and rent. No account or login required. ### Why use this actor - **No account needed** — works on public search pages. - **Any search, any filters** — paste an Idealista search URL (location, sale/rent, price, rooms) and the actor collects every result. - **Full listing details** — price, rooms, size (m²), floor, parking, description, and the listing agency. - **Spain, Italy & Portugal** — works across idealista.com / .it / .pt. - **Stable JSON output** — ready for spreadsheets, dashboards, or market analysis. - **Handles the site's protection automatically** — you don't manage browsers, sessions, or retries. ### How it works 1. Open Idealista, set your filters (location, sale/rent, price, rooms), and copy the address-bar URL. 2. Paste one or more of those URLs into **Search URLs**. 3. The actor collects every listing across the result pages, turning pages automatically until your limit. 4. Each listing becomes one row — downloadable as JSON, CSV, or Excel. A residential proxy in the site's country (Spain for idealista.com) is required and set by default. ### Use cases - **Real-estate market analysis** — track pricing, inventory, and size trends by area. - **Lead generation** — collect listings and the agencies behind them. - **Investment research** — filter by price/size/rooms across neighbourhoods. - **Portals & aggregators** — feed Idealista inventory into your own product. ### Input ```json { "startUrls": ["https://www.idealista.com/venta-viviendas/madrid-madrid/"], "maxItemsPerSearch": 0, "maxItems": 100, "maxPagesPerSearch": 60, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES" } } ```` | Field | Type | Description | |---|---|---| | `startUrls` | array | Idealista search-result URLs with filters applied. Copy from the site's address bar. | | `maxItemsPerSearch` | integer | Cap listings per search URL. `0` = all (up to the page limit). | | `maxItems` | integer | Overall cap for the run. `0` = no limit. Default `100`. | | `maxPagesPerSearch` | integer | Safety cap on result pages per search. Default `60`. | | `proxyConfiguration` | object | Residential proxy required; match the site's country (the default is Spain). | ### Output One record per listing: ```json { "_input": "https://www.idealista.com/venta-viviendas/madrid-madrid/", "_scrapedAt": "2026-06-16T13:30:00Z", "recordType": "LISTING", "id": "111756738", "url": "https://www.idealista.com/inmueble/111756738/", "title": "Piso en Calle de Fernández de la Hoz, Almagro, Madrid", "priceText": "1.950.000€", "price": 1950000, "rooms": 4, "sizeM2": 175, "floor": "5ª planta exterior con ascensor", "hasParking": true, "description": "ÚNICA inmobiliaria presenta esta extraordinaria vivienda señorial ...", "agency": "Única Consultoría Inmobiliaria", "tags": [], "detailsRaw": ["Garaje incluido", "4 hab.", "175 m²", "5ª planta exterior con ascensor"] } ``` | Field | Type | Description | |---|---|---| | `id` / `url` | string | Listing ID and link. | | `title` | string | Listing headline (street / area). | | `priceText` / `price` | string / number | Price as shown, and as a plain number. | | `rooms` / `sizeM2` / `floor` / `hasParking` | mixed | Parsed property details. | | `description` | string | Listing description. | | `agency` | string | Listing agency (when shown). | | `tags` | array | Listing badges. | | `detailsRaw` | array | The raw detail chips, as shown on the card. | Searches that fail are returned with an `_error` field, so nothing fails silently. ### Notes - Use a residential proxy in the site's country. For idealista.it / .pt, set the proxy country to IT / PT. - Idealista shows ~30 listings per page; very large searches are capped by the site itself (use tighter filters to go deeper). # Actor input Schema ## `startUrls` (type: `array`): Paste one or more Idealista search-result URLs with your filters applied (location, sale/rent, price, rooms). Open idealista.com / .it / .pt, set filters, copy the address bar. Example: https://www.idealista.com/venta-viviendas/madrid-madrid/ ## `maxItemsPerSearch` (type: `integer`): Cap listings collected per search URL. 0 = all available (up to the page limit). ## `maxItems` (type: `integer`): Overall cap across all searches in this run. 0 = no limit. ## `maxPagesPerSearch` (type: `integer`): Safety cap on how many result pages to turn per search. ## `proxyConfiguration` (type: `object`): Residential proxy is required. Choose the country of the site (Spain for idealista.com). ## Actor input object example ```json { "startUrls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ], "maxItemsPerSearch": 0, "maxItems": 100, "maxPagesPerSearch": 60, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } ``` # 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 = { "startUrls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/idealista-property-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 = { "startUrls": ["https://www.idealista.com/venta-viviendas/madrid-madrid/"] } # Run the Actor and wait for it to finish run = client.actor("xtracto/idealista-property-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 '{ "startUrls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ] }' | apify call xtracto/idealista-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/idealista-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealista Property Scraper", "description": "Collect property listings from Idealista (Spain, Italy, Portugal) — price, location, rooms, size, floor, description, and listing agency — from any search URL. For sale or rent.", "version": "0.1", "x-build-id": "Z0RdHTb9Sl2XHfwqE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~idealista-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-idealista-property-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/xtracto~idealista-property-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-idealista-property-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/xtracto~idealista-property-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-idealista-property-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": "Idealista search URLs", "type": "array", "description": "Paste one or more Idealista search-result URLs with your filters applied (location, sale/rent, price, rooms). Open idealista.com / .it / .pt, set filters, copy the address bar. Example: https://www.idealista.com/venta-viviendas/madrid-madrid/", "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max listings per search (0 = all)", "minimum": 0, "type": "integer", "description": "Cap listings collected per search URL. 0 = all available (up to the page limit).", "default": 0 }, "maxItems": { "title": "Max listings total (0 = all)", "minimum": 0, "type": "integer", "description": "Overall cap across all searches in this run. 0 = no limit.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap on how many result pages to turn per search.", "default": 60 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is required. Choose the country of the site (Spain for idealista.com).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } } }, "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 } } } } } } } } } } ```