# $0.5/1K πŸ”₯ Idealista Multi Countries Listings Scraper (`azzouzana/idealista-multi-countries-scraper`) Actor Fast - $0.5/1K πŸ’° Idealista real estate scraper (Spain, Italy, Portugal). Beats the 1.5K limit. Supports buy, rent or new homes => Extract 90+ property data points: prices, features, GPS coordinates, photos, agent contacts & much more! Paste URL β†’ JSON/Excel/API. AI-agents ready - Start now! πŸš€ - **URL**: https://apify.com/azzouzana/idealista-multi-countries-scraper.md - **Developed by:** [Azzouzana](https://apify.com/azzouzana) (community) - **Categories:** Real estate, Lead generation - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Multi Countries β€” Spain, Italy & Portugal Property Listing Scraper (By Search URL) Copy-pasting listings off **Idealista** one by one? Life’s too short. Paste a **search URL** from your browser β€” we turn it into clean, export-ready property data for **Spain**, **Italy**, and **Portugal** in minutes. Buy Β· rent Β· rooms Β· map areas Β· geo filters & much more. **No login. No paywall.** --- ### Built for Speed & Depth πŸš€ - **πŸ”— Zero-Friction Input** β€” Drop any Idealista search URL from `.com`, `.it`, or `.pt`. City pages, sorted results, map-drawn areas, geo filters β€” we parse it and run. - **One Actor, Three Markets** β€” Spain, Italy, and Portugal without switching tools. Country & language are detected from the URL. - **🏠 Full Listing Cards** β€” Price, rooms, bathrooms, size, floor, agents contact, property type, operation (sale/rent), status flags, and rich descriptions. - **πŸ“Έ Media That Matters** β€” Photo galleries, thumbnails, tags (bedroom, plan, views…), plus 360Β° / virtual tour links when Idealista exposes them. - **πŸ“ Location Intelligence** β€” Address, province, municipality, district, neighbourhood, `locationId`, latitude & longitude. - **πŸ§‘β€πŸ’Ό Agent & Agency Intel** β€” Commercial name, contact name, phone, agency logo, and microsite slug where shown on the listing. - **πŸ“ˆ Beyond the ~1,500 Wall** β€” Idealista caps results per pass; we paginate smartly and rotate collection passes so you can aim for **up to 5,000** unique listings per run. - **πŸ’° Pay Only for Results** β€” **$0.5 per 1,000 listings** pushed to your dataset. No hidden fees. - **πŸ“€ Export Anywhere** β€” JSON, CSV, Excel, or API β€” one row per property, ready for CRMs, sheets, and AI/data pipelines. --- ### πŸ› οΈ How to Play 1. [Create a free Apify account](https://apify.com/sign-up?fpr=cbgdsf) (no credit required). 2. Open this Actor in Apify Console. 3. On Idealista, run your search (buy, rent, rooms, map area, etc.). 4. Copy the URL from your address bar β†’ paste into **Start URL**. 5. Set **Max items** β†’ click **Start** β†’ download from the **Dataset** tab. #### Example URLs | Market | Example | |--------|---------| | Spain β€” rooms | `https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/` | | Italy β€” sorted | `https://www.idealista.it/en/vendita-case/firenze-firenze/?ordine=prezzi-asc` | | Portugal β€” geo | `https://www.idealista.pt/en/geo/comprar-casas/algarve/com-preco-max_320000,apartamentos/` | #### Input | Field | What it does | Default | |-------|----------------|---------| | **Start URL** | Idealista search URL (`.com` / `.it` / `.pt`) | Madrid rooms example | | **Max items** | How many listings to collect (min **5**, max **5,000**) | **5** | #### Example run ```json { "startUrl": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/", "maxItems": 100 } ```` *** ### πŸ’° The Math (It’s Friendly!) **$0.50 per 1,000 listings** extracted, no hidden fees, no actors start events, nothing. | Listings | Cost | |---------:|-----:| | 100 | $0.05 | | 1,000 | $0.50 | | 5,000 | $2.50 | *** ### πŸ†“ Free Tier Try before you scale: - **5 listings** per run β€” enough to validate fields & quality - **5 runs** per day (UTC) - **30 minutes** between runs [Upgrade for full volume](https://apify.com/pricing?fpr=cbgdsf) on any paid Apify plan. *** ### πŸ“¦ What’s in the Box? Each row = **one full Idealista listing object** β€” the same rich JSON Idealista returns (not a watered-down subset). ```json { "propertyCode": "100000001", "thumbnail": "https://example.com/dummy/idealista/thumbnail-01.jpg", "externalReference": "JD-REF-001", "numPhotos": 27, "floor": "en", "price": 250000, "priceInfo": { "price": { "amount": 250000, "currencySuffix": "€" } }, "propertyType": "studio", "operation": "sale", "size": 45, "rooms": 1, "bathrooms": 1, "address": "Studio in Via John Doe 12, Sample District, Example City", "province": "Example Province", "municipality": "Example City", "district": "Sample District", "country": "it", "neighborhood": "John Doe Quarter", "locationId": "0-EU-IT-XX-00-000-000-00-001", "latitude": 43.7700000, "longitude": 11.2550000, "showAddress": true, "url": "https://www.example.com/dummy/immobile/100000001/", "description": "Sample listing for documentation purposes only. This is dummy data featuring John Doe as the contact agent. Bright studio with approximately 45 sqm, one bedroom and one bathroom. Located in a central example neighbourhood. Price shown is fictional. Not a real property.", "hasVideo": false, "status": "renew", "newDevelopment": false, "favourite": false, "newProperty": false, "multimedia": { "images": [ { "url": "https://example.com/dummy/idealista/photo-03.jpg", "tag": "corridor" }, ... ], "virtual3DTours": [ { "url": "https://example.com/dummy/tours/john-doe-studio-360", "thumbnail": "https://example.com/dummy/idealista/tour-thumb-01.jpg", "category": "360" } ] }, "contactInfo": { "commercialName": "John Doe Realty β€” Example Branch", "phone1": { "phoneNumber": "5550100", "formattedPhone": "5550100", "prefix": "39", "phoneNumberForMobileDialing": "+395550100", "nationalNumber": true }, "contactName": "John Doe", "userType": "professional", "agencyLogo": "https://example.com/dummy/agency/john-doe-realty.png", "contactMethod": "all", "micrositeShortName": "john-doe-realty-example", "totalAds": 0, "needLoginForContact": false, "needLoginForPhone": false }, "hasLift": false, "priceByArea": 5555, "features": { "hasSwimmingPool": false, "hasTerrace": false, "hasAirConditioning": false, "hasBoxRoom": false, "hasGarden": false }, "detailedType": { "typology": "flat", "subTypology": "studio" }, "suggestedTexts": { "title": "Studio in Via John Doe 12, John Doe Quarter, Example City" }, "hasPlan": true, "has3DTour": false, "has360": true, "hasStaging": false, "savedAd": {}, "ribbons": [], "notes": [], "topNewDevelopment": false, "newDevelopmentHighlight": false, "topPlus": false, "preferenceHighlight": false, "topHighlight": false, "urgentVisualHighlight": false, "visualHighlight": false } ``` *(Dummy data β€” your runs return live Idealista fields.)* *** ### πŸ€” Why Scrape Idealista? - πŸ“Š **Investors & analysts** β€” prices, sizes, and stock by city or neighbourhood - 🎯 **Lead gen** β€” agency names & phones where publicly listed - πŸ—ΊοΈ **Market mapping** β€” compare Spain, Italy, and Portugal from one workflow - 🧩 **Data teams** β€” pipe listings into warehouses, BI tools, or internal apps *** ### ❓ FAQ #### Why only 5 results on the free plan? Free tier caps each run at **5 items** so you can inspect quality first. Upgrade to use your full **Max items**. #### Can I get more than ~1,500 listings from one search? Yes β€” Idealista limits each collection pass; this actor **paginates and extends collection** so you can gather more unique ads up to **5,000** (and your **Max items**). #### Why did my run stop early? Usually: (1) no more results for that search, (2) free-tier cap, or (3) daily rate limit (5 runs/day, 30-min gap). #### Is scraping Idealista legal? Public data for research is commonly acceptable; **you** must comply with local law and Idealista’s Terms. This tool is **not** affiliated with Idealista. #### Missing Information/Fields? This actor extracts property listings results from the discovery URLs only and does not dive into their individual details page. If you require comprehensive data, please open an issue so we can gauge user interest in this feature. *** ### πŸ”Ž SEO Keywords Idealista scraper, Idealista.com scraper, Idealista.it scraper, Idealista.pt scraper, scrape Idealista listings, Spain property scraper, Italy real estate scraper, Portugal property listings, Apify Idealista actor, web scraping Idealista, alquiler Idealista, venta viviendas, immobili Idealista Italia, imΓ³veis Idealista Portugal, Idealista API data *** ### ⭐ Looking for something else? - **Spain β€” fotocasa.es** β€” Need Spain’s largest property portal instead of Idealista? Try [$1/1K πŸ’™ Fotocasa.es Real Estate Scraper & Data Extractor API](https://apify.com/azzouzana/fotocasa-es-search-results-scraper-by-search-url-ppr?fpr=cbgdsf) β€” paste a Fotocasa search URL, pay per result (**$1 / 1K**). - **Italy β€” immobiliare.it** β€” Need Italy’s leading property portal instead of Idealista? Try [$1/1KπŸ’™ Immobiliare.it Scraper | Italy Real Estate API](https://apify.com/azzouzana/immobiliare-it-listing-page-scraper-by-search-url?fpr=cbgdsf) β€” same search-URL workflow, up to **5,000** listings per run. Browse thousands more scrapers on [Apify Store](https://apify.com/store?fpr=cbgdsf). *** ### πŸ“¬ Contact **Questions? Custom project? We’re here.** - πŸ’¬ Discord: `@azzouzana` - πŸ“§ Email: *** ### ⚠️ Disclaimer This Actor is **independent** and not affiliated with **Idealista S.A.** or Idealista.com / .it / .pt; trademarks belong to their owners. It collects only **publicly visible** listingsβ€”no login, no paywall, no accounts created for youβ€”and requests are throttled. Listings may contain personal data (phones, agent names, addresses, photos); once exported to **your** Apify dataset, **you** are responsible for lawful use under **GDPR**, **LOPDGDD**, Italy’s privacy rules, or **RGPD** as applicable: keep only what you need, secure your data, avoid unsolicited contact, and follow **Idealista’s terms**β€”do not republish ads as a competing portal. We do not store your results; retention and deletion are yours to manage. # Actor input Schema ## `startUrl` (type: `string`): Idealista search results URL from idealista.com, idealista.it, or idealista.pt (copy from your browser address bar). ## `maxItems` (type: `integer`): Maximum listings to collect. Effective limit also respects run budget and free-tier cap (5 for free users). ## Actor input object example ```json { "startUrl": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/", "maxItems": 1500 } ``` # 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 = { "startUrl": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/", "maxItems": 1500 }; // Run the Actor and wait for it to finish const run = await client.actor("azzouzana/idealista-multi-countries-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 = { "startUrl": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/", "maxItems": 1500, } # Run the Actor and wait for it to finish run = client.actor("azzouzana/idealista-multi-countries-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 '{ "startUrl": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/", "maxItems": 1500 }' | apify call azzouzana/idealista-multi-countries-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=azzouzana/idealista-multi-countries-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "$0.5/1K πŸ”₯ Idealista Multi Countries Listings Scraper", "description": "Fast - $0.5/1K πŸ’° Idealista real estate scraper (Spain, Italy, Portugal). Beats the 1.5K limit. Supports buy, rent or new homes => Extract 90+ property data points: prices, features, GPS coordinates, photos, agent contacts & much more! Paste URL β†’ JSON/Excel/API. AI-agents ready - Start now! πŸš€", "version": "0.0", "x-build-id": "ZTo9d4EQH3UiXR4bO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/azzouzana~idealista-multi-countries-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-azzouzana-idealista-multi-countries-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/azzouzana~idealista-multi-countries-scraper/runs": { "post": { "operationId": "runs-sync-azzouzana-idealista-multi-countries-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/azzouzana~idealista-multi-countries-scraper/run-sync": { "post": { "operationId": "run-sync-azzouzana-idealista-multi-countries-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": [ "startUrl" ], "properties": { "startUrl": { "title": "Idealista Search Page URL", "type": "string", "description": "Idealista search results URL from idealista.com, idealista.it, or idealista.pt (copy from your browser address bar).", "default": "https://www.idealista.com/en/alquiler-habitacion/madrid-madrid/" }, "maxItems": { "title": "Max items", "minimum": 5, "maximum": 5000, "type": "integer", "description": "Maximum listings to collect. Effective limit also respects run budget and free-tier cap (5 for free users).", "default": 1500 } } }, "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 } } } } } } } } } } ```