# Idealista $1💰 Search By URLs and Keywords (`abotapi/idealista-scraper`) Actor From $1/1K. Extract property listings from Idealista Spain, Italy, and Portugal. Get prices, sizes, rooms, coordinates, advertiser details, phone numbers, descriptions, photos, and 35+ fields per listing. Supports buy, rent, and rooms via filters or direct Idealista URLs. Blazing fast, reliable. - **URL**: https://apify.com/abotapi/idealista-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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. 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 Scraper (Spain, Italy, Portugal) Extract property listings from idealista across its three markets: idealista.com (Spain), idealista.it (Italy), and idealista.pt (Portugal). The scraper pulls prices, size, rooms, coordinates, advertiser and phone, full descriptions, photo galleries, and 35+ fields per listing. It supports buy, rent, and rooms, with a Search mode that builds URLs for you and a URL mode that scrapes any idealista search link you paste. ### Why this scraper - Three markets in one actor: Spain, Italy, and Portugal, selectable per run. - 50+ fields per listing, including price per m2, energy rating, GPS coordinates, advertiser name and phone, construction year, the full description, and the complete photo gallery with no repeated images. - Two modes: search by location, or paste idealista URLs directly (multi-URL supported, with forward pagination). - Buy, rent, and room listings, plus price and bedroom filters (Search mode) that work the same in every market. In URL mode the pasted URL's own filters apply. - Fast and cost-efficient: low memory footprint and quick runs keep large pulls cheap. - Optional detail enrichment: turn it off for a faster, lean run, or on for the full record. ### Data you get > Sample shape: values are illustrative placeholders, not from a live listing. | Field | Example | | --- | --- | | id | "00000001" | | url | "https://www.idealista.com/inmueble/00000001/" | | market | "ES" | | operation | "sale" | | title | "Sample Flat in Example Street" | | propertyType | "flat" | | price | 450000 | | priceText | "450.000 EUR" | | pricePerM2 | 4736 | | previousPrice | 480000 | | priceDropped | true | | currency | "EUR" | | size | 95.0 | | rooms | 3 | | bathrooms | 2 | | floor | "3rd floor with lift" | | hasLift | true | | hasTerrace | true | | hasGarage | false | | orientation | "South facing" | | heating | "Central heating" | | condition | "Second hand, good condition" | | constructionYear | 1985 | | energyConsumptionRating | "D" | | energyEmissionsRating | "D" | | reference | "REF-0001" | | lastUpdatedText | "Listing updated on 1 January" | | neighborhood | "Example District" | | city | "Example City" | | photoCount | 24 | | isBranded | true | | hasVideo | true | | has3DTour | false | | hasFloorPlan | true | | description | "Full advertiser description text appears here when fetchDetails is on." | | latitude | 40.0000 | | longitude | -3.0000 | | address | "Example District, Example City" | | advertiserName | "Sample Agency" | | advertiserType | "professional" | | phone | "+34 000 000 000" | | features | ["95 m2", "3 rooms", "2 bathrooms", "terrace"] | | images | ["https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/00/00/00/000000000.jpg"] | | imageCount | 24 | | thumbnail | "https://img4.idealista.com/blur/591_420_mq/0/id.pro.es.image.master/00/00/00/000000000.jpg" | | tags | ["price drop"] | | source | "www.idealista.com" | | scrapedAt | "2026-01-01T00:00:00.000000+00:00" | ### How to use Search Spain (Madrid), buy, lean run: ```json { "mode": "search", "market": "es", "operation": "sale", "locations": ["madrid-madrid"], "maxPages": 3, "maxListings": 90, "fetchDetails": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES" } } ```` Search with price and bedroom filters, full detail: ```json { "mode": "search", "market": "es", "operation": "sale", "locations": ["barcelona-barcelona"], "minPrice": 200000, "maxPrice": 500000, "minBedrooms": 3, "fetchDetails": true, "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES" } } ``` Search Italy (rent in Rome): ```json { "mode": "search", "market": "it", "operation": "rent", "locations": ["roma-roma"], "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT" } } ``` URL mode (paste idealista search links, multiple supported): ```json { "mode": "url", "urls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/", "https://www.idealista.pt/comprar-casas/lisboa/" ], "maxPages": 2, "fetchDetails": true } ``` ### Input parameters | Parameter | Type | Default | Description | | --- | --- | --- | --- | | mode | string | "search" | "search" or "url". | | market | string | "es" | Market for Search mode: es, it, or pt. URL mode infers it per URL. | | operation | string | "sale" | sale, rent, or room (Search mode). | | locations | array | \["madrid-madrid"] | idealista location slugs (Search mode). | | urls | array | (example) | idealista search URLs (URL mode). | | minPrice | integer | (none) | Minimum price. Search mode only. | | maxPrice | integer | (none) | Maximum price. Search mode only. | | minBedrooms | integer | (none) | Minimum rooms. Search mode only. | | maxBedrooms | integer | (none) | Maximum rooms. Search mode only. | | maxPages | integer | 60 | Pages per search (30 per page). 60 is idealista's per-search ceiling (~1,800 listings); runs are also bounded by maxListings. | | maxListings | integer | 100 | Total listings cap across all searches. 0 means unlimited. | | maxConcurrency | integer | 6 | Parallel detail fetches (1 to 12) when detail pages are on. | | fetchDetails | boolean | true | Open detail pages for coordinates, advertiser, phone, full description, and photos. | | proxy | object | Residential | Proxy configuration. Residential in the listing's country is recommended. | ### Output example > Sample shape: values are illustrative placeholders, not from a live listing. ```json { "id": "00000001", "url": "https://www.idealista.com/inmueble/00000001/", "market": "ES", "operation": "sale", "title": "Sample Flat in Example Street", "propertyType": "flat", "price": 450000, "priceText": "450.000 EUR", "pricePerM2": 4736, "previousPrice": 480000, "priceDropped": true, "currency": "EUR", "size": 95.0, "rooms": 3, "bathrooms": 2, "floor": "3rd floor with lift", "hasLift": true, "hasTerrace": true, "orientation": "South facing", "heating": "Central heating", "condition": "Second hand, good condition", "constructionYear": 1985, "energyConsumptionRating": "D", "energyEmissionsRating": "D", "reference": "REF-0001", "lastUpdatedText": "Listing updated on 1 January", "description": "Full advertiser description text appears here when fetchDetails is on.", "latitude": 40.0000, "longitude": -3.0000, "address": "Example District, Example City", "neighborhood": "Example District", "city": "Example City", "photoCount": 24, "isBranded": true, "hasVideo": true, "has3DTour": false, "hasFloorPlan": true, "advertiserName": "Sample Agency", "advertiserType": "professional", "phone": "+34 000 000 000", "features": ["95 m2", "3 rooms", "2 bathrooms", "terrace"], "images": ["https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/00/00/00/000000000.jpg"], "imageCount": 24, "source": "www.idealista.com", "scrapedAt": "2026-01-01T00:00:00.000000+00:00" } ``` ### Plan requirements idealista serves listings only to residential connections in the listing's country, so a residential proxy is required for reliable results. On Apify, residential proxy access is included from the Starter plan upward. The actor defaults the proxy country to your chosen market. Free-tier accounts without residential access will likely receive zero results; add residential proxy credit and re-run. # Actor input Schema ## `mode` (type: `string`): How to find listings. 'Search by Location' builds URLs from the fields below; 'Direct URLs' scrapes the idealista search URLs you paste. ## `market` (type: `string`): Which idealista market to search (Search mode only). URL mode infers the market from each URL. ## `operation` (type: `string`): Buy, rent, or rent a room (Search mode only). ## `locations` (type: `array`): idealista location slugs (Search mode only). Examples: ES 'madrid-madrid', 'barcelona-barcelona'; IT 'roma-roma', 'milano-milano'; PT 'lisboa', 'porto'. Tip: open the area on idealista and copy the slug from the URL. ## `minPrice` (type: `integer`): Minimum price (Search mode only; in URL mode the pasted URL's own filters apply). Applied to results. ## `maxPrice` (type: `integer`): Maximum price (Search mode only). Applied to results. ## `minBedrooms` (type: `integer`): Minimum number of rooms (Search mode only). Applied to results. ## `maxBedrooms` (type: `integer`): Maximum number of rooms (Search mode only). Applied to results. ## `urls` (type: `array`): idealista search URLs to scrape (URL mode only). Multi-URL supported. Filter fields are ignored in this mode. Pagination starts at the page in the URL and walks forward. ## `maxPages` (type: `integer`): Maximum pages to paginate per search (30 listings per page). idealista serves at most about 60 pages (~1,800 listings) per search, so 60 is the effective ceiling; the run is also bounded by Max Listings. Lower it only for quick test runs. ## `maxListings` (type: `integer`): Maximum listings to return across all searches. Set 0 for unlimited. For large pulls (e.g. 10,000), provide many locations or filtered URLs: idealista shows at most about 1,800 listings (page 60) per single search, so big runs must be partitioned across several areas or price bands. ## `maxConcurrency` (type: `integer`): Parallel detail-page fetches when Fetch Detail Pages is on. Higher is faster but puts more load on the proxy. 1 to 12. ## `fetchDetails` (type: `boolean`): Open each listing's detail page to add coordinates, agent and phone, full description, all photos, bathrooms, condition, orientation, and heating. Turn off for a faster, lighter run with SERP fields only. ## `proxy` (type: `object`): Residential proxy in the listing's country is strongly recommended. The actor defaults the country to the chosen market and rotates across EU pools when needed. ## Actor input object example ```json { "mode": "search", "market": "es", "operation": "sale", "locations": [ "madrid-madrid" ], "urls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ], "maxPages": 60, "maxListings": 100, "maxConcurrency": 6, "fetchDetails": true, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "locations": [ "madrid-madrid" ], "urls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/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 = { "locations": ["madrid-madrid"], "urls": ["https://www.idealista.com/venta-viviendas/madrid-madrid/"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/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 '{ "locations": [ "madrid-madrid" ], "urls": [ "https://www.idealista.com/venta-viviendas/madrid-madrid/" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call abotapi/idealista-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/idealista-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealista $1💰 Search By URLs and Keywords", "description": "From $1/1K. Extract property listings from Idealista Spain, Italy, and Portugal. Get prices, sizes, rooms, coordinates, advertiser details, phone numbers, descriptions, photos, and 35+ fields per listing. Supports buy, rent, and rooms via filters or direct Idealista URLs. Blazing fast, reliable.", "version": "1.0", "x-build-id": "WswZZzbZWIvWua7CQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~idealista-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-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/abotapi~idealista-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-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/abotapi~idealista-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-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", "required": [ "mode" ], "properties": { "mode": { "title": "Search Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to find listings. 'Search by Location' builds URLs from the fields below; 'Direct URLs' scrapes the idealista search URLs you paste.", "default": "search" }, "market": { "title": "Market", "enum": [ "es", "it", "pt" ], "type": "string", "description": "Which idealista market to search (Search mode only). URL mode infers the market from each URL.", "default": "es" }, "operation": { "title": "Operation", "enum": [ "sale", "rent", "room" ], "type": "string", "description": "Buy, rent, or rent a room (Search mode only).", "default": "sale" }, "locations": { "title": "Locations", "type": "array", "description": "idealista location slugs (Search mode only). Examples: ES 'madrid-madrid', 'barcelona-barcelona'; IT 'roma-roma', 'milano-milano'; PT 'lisboa', 'porto'. Tip: open the area on idealista and copy the slug from the URL.", "items": { "type": "string" } }, "minPrice": { "title": "Min Price (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price (Search mode only; in URL mode the pasted URL's own filters apply). Applied to results." }, "maxPrice": { "title": "Max Price (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price (Search mode only). Applied to results." }, "minBedrooms": { "title": "Min Bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum number of rooms (Search mode only). Applied to results." }, "maxBedrooms": { "title": "Max Bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum number of rooms (Search mode only). Applied to results." }, "urls": { "title": "Search URLs", "type": "array", "description": "idealista search URLs to scrape (URL mode only). Multi-URL supported. Filter fields are ignored in this mode. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "maxPages": { "title": "Max Pages Per Search", "minimum": 1, "maximum": 60, "type": "integer", "description": "Maximum pages to paginate per search (30 listings per page). idealista serves at most about 60 pages (~1,800 listings) per search, so 60 is the effective ceiling; the run is also bounded by Max Listings. Lower it only for quick test runs.", "default": 60 }, "maxListings": { "title": "Max Listings", "minimum": 0, "type": "integer", "description": "Maximum listings to return across all searches. Set 0 for unlimited. For large pulls (e.g. 10,000), provide many locations or filtered URLs: idealista shows at most about 1,800 listings (page 60) per single search, so big runs must be partitioned across several areas or price bands.", "default": 100 }, "maxConcurrency": { "title": "Detail Concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Parallel detail-page fetches when Fetch Detail Pages is on. Higher is faster but puts more load on the proxy. 1 to 12.", "default": 6 }, "fetchDetails": { "title": "Fetch Detail Pages", "type": "boolean", "description": "Open each listing's detail page to add coordinates, agent and phone, full description, all photos, bathrooms, condition, orientation, and heating. Turn off for a faster, lighter run with SERP fields only.", "default": true }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy in the listing's country is strongly recommended. The actor defaults the country to the chosen market and rotates across EU pools when needed." } } }, "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 } } } } } } } } } } ```