# ๐Ÿ  Idealista Scraper (`scraper-engine/idealista-scraper`) Actor ๐Ÿ  Idealista Scraper (idealista-scraper) extracts listings & key property details from Idealistaโ€”price, location, size, features & more. ๐Ÿš€ Fast, reliable data for real estate analytics, lead gen, and market research. - **URL**: https://apify.com/scraper-engine/idealista-scraper.md - **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community) - **Categories:** Real estate, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 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. 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 Scraper โ€” Spain ยท Portugal ยท Italy Real Estate Extract **real-estate listings from [Idealista](https://www.idealista.com)** at scale โ€” properties **for sale or rent** across **๐Ÿ‡ช๐Ÿ‡ธ Spain, ๐Ÿ‡ต๐Ÿ‡น Portugal and ๐Ÿ‡ฎ๐Ÿ‡น Italy**. Search by location, paste listing URLs or property codes, apply rich filters, and get clean, structured JSON with prices, sizes, photos, geolocation, agent contacts and (optionally) full property details and engagement statistics. This Actor talks to Idealista's official **mobile-app API**, so results are fast, complete and consistently structured โ€” and a **smart auto-escalating proxy** keeps it running even when requests get blocked. ### โญ Why choose this Actor? - **Fast & reliable** โ€” direct mobile-API access, not fragile HTML scraping. - **Self-healing proxies** โ€” starts with no proxy, automatically escalates to datacenter and then residential proxies on blocks, then sticks with what works. - **Live results** โ€” every property is saved the moment it's ready; a crash never loses finished work. - **Deeply structured output** โ€” search fields + optional `_details` and `_stats`. - **Bulk-friendly** โ€” paste many listing URLs / property codes, or search whole cities. ### ๐Ÿ”‘ Key features - Sale & rent, 9 property types (homes, new developments, offices, garages, landsโ€ฆ). - 40+ filters: price, size, bedrooms, bathrooms, condition, floor, amenities, agencyโ€ฆ - Automatic sub-location splitting to exceed the per-search pagination cap. - Optional per-property enrichment (`_details`, `_stats`). - Real-time, emoji-rich logs and a tabbed Output view (Overview ยท Location ยท Features ยท Contact). ### ๐Ÿ“ฅ Input ```json { "location": "0-EU-ES-28-07-001-079", "country": "es", "operation": "sale", "propertyType": "homes", "maxItems": 50, "sortBy": "mostRecent", "fetchDetails": true, "fetchStats": true, "proxyConfiguration": { "useApifyProxy": false } } ```` | Field | Meaning | |---|---| | `startUrls` | Bulk Idealista listing URLs; property codes are auto-extracted. | | `propertyCodes` | Idealista property codes to fetch directly (skips search & filters). | | `location` | City name (e.g. `Madrid`) or Idealista Location ID. | | `country` | `es` ยท `pt` ยท `it`. | | `operation` | `sale` or `rent`. | | `propertyType` | `homes`, `newDevelopments`, `offices`, `premises`, `garages`, `lands`, `storageRooms`, `buildings`, `bedrooms`. | | `maxItems` | Max listings (0 = unlimited; >2500 auto-splits by sub-location). | | `sortBy` | Result ordering (most recent, lowest price, biggestโ€ฆ). | | `fetchDetails` / `fetchStats` | Add `_details` / `_stats` per property (slower). | | Price/size/filters/amenities | See the input form โ€” all optional. | | `proxyConfiguration` | Proxy. Default: no proxy with auto-escalation. | ### ๐Ÿ“ค Output Each dataset item is a full Idealista listing. With enrichment on, it also carries `_details` (full description, all photos, characteristics, agent info) and `_stats` (views, favourites, contacts): ```json { "propertyCode": "111666344", "operation": "sale", "propertyType": "flat", "price": 700000, "priceByArea": 5645, "size": 124, "rooms": 4, "bathrooms": 2, "status": "good", "address": "Piso en Calle de Fermรญn Caballero, 85, Peรฑagrande, Madrid", "province": "Madrid", "municipality": "Madrid", "district": "Fuencarral", "neighborhood": "Peรฑagrande", "latitude": 40.4794993, "longitude": -3.7182544, "thumbnail": "https://img4.idealista.com/...", "url": "https://www.idealista.com/inmueble/111666344/", "_details": { "...": "full property detail" }, "_stats": { "views": { "value": 0 }, "favorites": { "value": 0 } } } ``` ### ๐Ÿš€ How to use the Actor (via Apify Console) 1. Log in at โ†’ **Actors**. 2. Open **Idealista Scraper**. 3. Set a **location** (or paste URLs / property codes) and tune filters. 4. (Optional) Enable **Fetch details / stats** for richer data. 5. Click **Start** and watch the real-time logs. 6. Open the **Output** tab โ€” switch between **Overview ยท Location ยท Features ยท Contact** views. 7. Export to **JSON / CSV / Excel** or pull via the **API**. ### ๐Ÿ™๏ธ Best use cases - Market analysis & price benchmarking by area. - Lead generation for agencies and investors. - Building property datasets for ML / dashboards. - Monitoring new listings with `publicationDate` filters. ### ๐Ÿ’ธ Pricing This Actor uses **pay-per-event** pricing: a small charge when the run starts plus a small charge per property saved. You only pay for results you receive. ### โ“ FAQ **Where do I find a Location ID?** Use the [Idealista Location Search tool](https://igolaizola.github.io/idealista-scraper), or just type a city name and the Actor resolves it. **Why enrichment is slower?** `_details`/`_stats` each add one request per property (~50ร— more requests), so enable them only when you need that depth. **Do I need a proxy?** No. The Actor starts without one and escalates automatically only if Idealista blocks the request. ### โš–๏ธ Legal & ethics Only public listing data is collected. You are responsible for complying with applicable laws and Idealista's Terms of Service in your jurisdiction. ### ๐Ÿ›Ÿ Support Found a bug or need a new field? Open an issue on the Actor's **Issues** tab in the Apify Console. # Actor input Schema ## `location` (type: `string`): City name (e.g. Madrid) or an Idealista Location ID (e.g. 0-EU-ES-28-07-001-079). Tip: use the Idealista Location Search tool (https://igolaizola.github.io/idealista-scraper) to find an exact Location ID. ## `country` (type: `string`): Which Idealista marketplace to search. ## `operation` (type: `string`): Buy or rent. ## `propertyType` (type: `string`): Type of property to search. ## `maxItems` (type: `integer`): Maximum number of listings to scrape (0 = unlimited). Above 2500 the location is auto-split into sub-locations, which groups results by sub-location. ## `sortBy` (type: `string`): Ordering of the search results. ## `fetchDetails` (type: `boolean`): Add a rich '\_details' object to every property (full description, all photos, characteristics, agent infoโ€ฆ). Roughly 50ร— slower because each property needs its own request. ## `fetchStats` (type: `boolean`): Add a '\_stats' object to every property (views, favourites, e-mail contacts, sent-to-friend). Roughly 50ร— slower. ## `minPrice` (type: `string`): Minimum price (0 = any). ## `maxPrice` (type: `string`): Maximum price (0 = any). ## `minSize` (type: `string`): Minimum size in mยฒ (0 = any). ## `maxSize` (type: `string`): Maximum size in mยฒ (0 = any). ## `publicationDate` (type: `string`): Only listings published within this window. ## `rentalTypes` (type: `array`): Rental usage type. Leave empty for any. ## `bedrooms` (type: `array`): Number of bedrooms. Leave empty for any. ## `bathrooms` (type: `array`): Number of bathrooms. Leave empty for any. ## `homeType` (type: `array`): Home typologies. Leave empty for any. ## `condition` (type: `array`): Property condition. Leave empty for any. ## `propertyStatus` (type: `array`): Ownership / occupancy status. Leave empty for any. ## `floor` (type: `array`): Floor level. Leave empty for any. ## `airConditioning` (type: `boolean`): Only properties with air conditioning. ## `fittedWardrobes` (type: `boolean`): Only properties with fitted wardrobes. ## `lift` (type: `boolean`): Only properties with a lift. ## `balcony` (type: `boolean`): Only properties with a balcony. ## `terrace` (type: `boolean`): Only properties with a terrace. ## `exterior` (type: `boolean`): Only exterior properties. ## `garage` (type: `boolean`): Only properties with garage or parking. ## `garden` (type: `boolean`): Only properties with a garden. ## `swimmingPool` (type: `boolean`): Only properties with a swimming pool. ## `storageRoom` (type: `boolean`): Only properties with a storage room. ## `accessible` (type: `boolean`): Only accessible properties. ## `seaViews` (type: `boolean`): Only properties with sea views. ## `luxury` (type: `boolean`): Only luxury homes. ## `plan` (type: `boolean`): Only properties with a floor plan. ## `virtualTour` (type: `boolean`): Only properties with a virtual tour. ## `agency` (type: `string`): Filter by agency using the slug from its page URL, e.g. 'engel-volkers' from https://www.idealista.com/pro/engel-volkers/. ## `proxyConfiguration` (type: `object`): Proxy settings. By default the actor starts with NO proxy and automatically escalates to a datacenter proxy and then a residential proxy if Idealista blocks the request (and sticks with residential afterwards). You can still force a specific Apify proxy group here. ## Actor input object example ```json { "location": "0-EU-ES-28-07-001-079", "country": "es", "operation": "sale", "propertyType": "homes", "maxItems": 10, "sortBy": "mostRecent", "fetchDetails": false, "fetchStats": false, "minPrice": "0", "maxPrice": "0", "minSize": "0", "maxSize": "0", "publicationDate": "", "airConditioning": false, "fittedWardrobes": false, "lift": false, "balcony": false, "terrace": false, "exterior": false, "garage": false, "garden": false, "swimmingPool": false, "storageRoom": false, "accessible": false, "seaViews": false, "luxury": false, "plan": false, "virtualTour": false, "agency": "", "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "location": "0-EU-ES-28-07-001-079", "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scraper-engine/idealista-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 = { "location": "0-EU-ES-28-07-001-079", "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scraper-engine/idealista-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 '{ "location": "0-EU-ES-28-07-001-079", "proxyConfiguration": { "useApifyProxy": false } }' | apify call scraper-engine/idealista-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper-engine/idealista-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "๐Ÿ  Idealista Scraper", "description": "๐Ÿ  Idealista Scraper (idealista-scraper) extracts listings & key property details from Idealistaโ€”price, location, size, features & more. ๐Ÿš€ Fast, reliable data for real estate analytics, lead gen, and market research.", "version": "0.1", "x-build-id": "McNSdKNNSDpCbS3w1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~idealista-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-idealista-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/scraper-engine~idealista-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-idealista-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/scraper-engine~idealista-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-idealista-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": { "location": { "title": "๐ŸŒ Location", "type": "string", "description": "City name (e.g. Madrid) or an Idealista Location ID (e.g. 0-EU-ES-28-07-001-079). Tip: use the Idealista Location Search tool (https://igolaizola.github.io/idealista-scraper) to find an exact Location ID.", "default": "0-EU-ES-28-07-001-079" }, "country": { "title": "๐Ÿ—บ๏ธ Country", "enum": [ "es", "pt", "it" ], "type": "string", "description": "Which Idealista marketplace to search.", "default": "es" }, "operation": { "title": "๐Ÿท๏ธ Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Buy or rent.", "default": "sale" }, "propertyType": { "title": "๐Ÿ˜๏ธ Property type", "enum": [ "homes", "newDevelopments", "offices", "premises", "garages", "lands", "storageRooms", "buildings", "bedrooms" ], "type": "string", "description": "Type of property to search.", "default": "homes" }, "maxItems": { "title": "๐Ÿ” Max items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited). Above 2500 the location is auto-split into sub-locations, which groups results by sub-location.", "default": 10 }, "sortBy": { "title": "โ†•๏ธ Sort by", "enum": [ "relevance", "closest", "lowestPrice", "highestPrice", "mostRecent", "leastRecent", "highestPriceReduction", "lowestPriceM2", "highestPriceM2", "biggest", "smallest", "highestFloors", "lowestFloors" ], "type": "string", "description": "Ordering of the search results.", "default": "mostRecent" }, "fetchDetails": { "title": "๐Ÿ“‹ Fetch details (slower โ€” 1 extra request each)", "type": "boolean", "description": "Add a rich '_details' object to every property (full description, all photos, characteristics, agent infoโ€ฆ). Roughly 50ร— slower because each property needs its own request.", "default": false }, "fetchStats": { "title": "๐Ÿ“Š Fetch statistics (slower โ€” 1 extra request each)", "type": "boolean", "description": "Add a '_stats' object to every property (views, favourites, e-mail contacts, sent-to-friend). Roughly 50ร— slower.", "default": false }, "minPrice": { "title": "๐Ÿ’ถ Min price", "enum": [ "0", "500", "550", "600", "650", "700", "750", "800", "850", "900", "950", "1000", "1100", "1200", "1300", "1400", "1500", "1600", "1700", "1800", "1900", "2000", "2100", "2400", "2700", "3000", "50000", "75000", "100000", "125000", "150000", "175000", "200000", "225000", "250000", "275000", "300000", "325000", "350000", "375000", "400000", "425000", "450000", "475000", "500000", "550000", "600000", "650000", "700000", "750000", "800000", "850000", "900000", "950000", "1000000", "1100000", "1200000", "1300000", "1400000", "1500000", "1600000", "1700000", "1800000", "1900000", "2000000", "2250000", "2500000", "2750000", "3000000", "3500000", "4000000" ], "type": "string", "description": "Minimum price (0 = any).", "default": "0" }, "maxPrice": { "title": "๐Ÿ’ถ Max price", "enum": [ "0", "500", "550", "600", "650", "700", "750", "800", "850", "900", "950", "1000", "1100", "1200", "1300", "1400", "1500", "1600", "1700", "1800", "1900", "2000", "2100", "2400", "2700", "3000", "50000", "75000", "100000", "125000", "150000", "175000", "200000", "225000", "250000", "275000", "300000", "325000", "350000", "375000", "400000", "425000", "450000", "475000", "500000", "550000", "600000", "650000", "700000", "750000", "800000", "850000", "900000", "950000", "1000000", "1100000", "1200000", "1300000", "1400000", "1500000", "1600000", "1700000", "1800000", "1900000", "2000000", "2250000", "2500000", "2750000", "3000000", "3500000", "4000000" ], "type": "string", "description": "Maximum price (0 = any).", "default": "0" }, "minSize": { "title": "๐Ÿ“ Min size", "enum": [ "0", "60", "80", "100", "120", "140", "160", "180", "200", "220", "240", "260", "280", "300" ], "type": "string", "description": "Minimum size in mยฒ (0 = any).", "default": "0" }, "maxSize": { "title": "๐Ÿ“ Max size", "enum": [ "0", "60", "80", "100", "120", "140", "160", "180", "200", "220", "240", "260", "280", "300" ], "type": "string", "description": "Maximum size in mยฒ (0 = any).", "default": "0" }, "publicationDate": { "title": "๐Ÿ“… Publication date", "enum": [ "", "Y", "T", "W", "M" ], "type": "string", "description": "Only listings published within this window.", "default": "" }, "rentalTypes": { "title": "๐Ÿ”‘ Rental types (rent only)", "type": "array", "description": "Rental usage type. Leave empty for any.", "items": { "type": "string", "enum": [ "longTerm", "seasonal" ], "enumTitles": [ "Long-term residential", "Short-term / seasonal" ] } }, "bedrooms": { "title": "๐Ÿ›๏ธ Bedrooms", "type": "array", "description": "Number of bedrooms. Leave empty for any.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4" ], "enumTitles": [ "Studio", "1 bedroom", "2 bedrooms", "3 bedrooms", "4+ bedrooms" ] } }, "bathrooms": { "title": "๐Ÿ› Bathrooms", "type": "array", "description": "Number of bathrooms. Leave empty for any.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "1 bathroom", "2 bathrooms", "3+ bathrooms" ] } }, "homeType": { "title": "๐Ÿก Home types", "type": "array", "description": "Home typologies. Leave empty for any.", "items": { "type": "string", "enum": [ "flat", "penthouse", "duplex", "detachedHouse", "semiDetachedHouse", "terracedHouse", "countryHouse", "apartment", "villa", "loft" ], "enumTitles": [ "Flat", "Penthouse", "Duplex", "Detached house", "Semi-detached house", "Terraced house", "Country house", "Apartment", "Villa", "Loft" ] } }, "condition": { "title": "๐Ÿ› ๏ธ Condition", "type": "array", "description": "Property condition. Leave empty for any.", "items": { "type": "string", "enum": [ "newDevelopment", "good", "renew" ], "enumTitles": [ "New homes", "Good condition", "Needs renovation" ] } }, "propertyStatus": { "title": "๐Ÿ“‘ Property status", "type": "array", "description": "Ownership / occupancy status. Leave empty for any.", "items": { "type": "string", "enum": [ "bareOwnership", "tenanted", "illegallyOccupied", "free" ], "enumTitles": [ "Bare ownership", "Rented, with tenants", "Illegally occupied", "Available (none of the above)" ] } }, "floor": { "title": "๐Ÿข Floor", "type": "array", "description": "Floor level. Leave empty for any.", "items": { "type": "string", "enum": [ "topFloor", "intermediateFloor", "groundFloor" ], "enumTitles": [ "Top floor", "Middle floors", "Ground floor" ] } }, "airConditioning": { "title": "โ„๏ธ Air conditioning", "type": "boolean", "description": "Only properties with air conditioning.", "default": false }, "fittedWardrobes": { "title": "๐Ÿšช Fitted wardrobes", "type": "boolean", "description": "Only properties with fitted wardrobes.", "default": false }, "lift": { "title": "๐Ÿ›— Lift", "type": "boolean", "description": "Only properties with a lift.", "default": false }, "balcony": { "title": "๐ŸชŸ Balcony", "type": "boolean", "description": "Only properties with a balcony.", "default": false }, "terrace": { "title": "โ˜€๏ธ Terrace", "type": "boolean", "description": "Only properties with a terrace.", "default": false }, "exterior": { "title": "๐ŸŒ‡ Exterior", "type": "boolean", "description": "Only exterior properties.", "default": false }, "garage": { "title": "๐Ÿš— Garage / parking", "type": "boolean", "description": "Only properties with garage or parking.", "default": false }, "garden": { "title": "๐ŸŒณ Garden", "type": "boolean", "description": "Only properties with a garden.", "default": false }, "swimmingPool": { "title": "๐ŸŠ Swimming pool", "type": "boolean", "description": "Only properties with a swimming pool.", "default": false }, "storageRoom": { "title": "๐Ÿ“ฆ Storage room", "type": "boolean", "description": "Only properties with a storage room.", "default": false }, "accessible": { "title": "โ™ฟ Accessible", "type": "boolean", "description": "Only accessible properties.", "default": false }, "seaViews": { "title": "๐ŸŒŠ Sea views", "type": "boolean", "description": "Only properties with sea views.", "default": false }, "luxury": { "title": "๐Ÿ’Ž Luxury", "type": "boolean", "description": "Only luxury homes.", "default": false }, "plan": { "title": "๐Ÿ—บ๏ธ Floor plan", "type": "boolean", "description": "Only properties with a floor plan.", "default": false }, "virtualTour": { "title": "๐ŸŽฅ Virtual tour", "type": "boolean", "description": "Only properties with a virtual tour.", "default": false }, "agency": { "title": "๐Ÿข Agency slug", "type": "string", "description": "Filter by agency using the slug from its page URL, e.g. 'engel-volkers' from https://www.idealista.com/pro/engel-volkers/.", "default": "" }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy configuration", "type": "object", "description": "Proxy settings. By default the actor starts with NO proxy and automatically escalates to a datacenter proxy and then a residential proxy if Idealista blocks the request (and sticks with residential afterwards). You can still force a specific Apify proxy group here.", "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 } } }, "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 } } } } } } } } } } ```