# Idealista Scraper (Cheap) (`data_api/idealista-scraper-cheap`) Actor Idealista property scraper that collects prices, bedrooms, sizes, photos, and agency details from any search URL, so you can track asking prices and dig into the market without clicking through pages one by one. - **URL**: https://apify.com/data\_api/idealista-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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 Property Scraper ![Idealista Property Scraper](cover.jpg) Watching the Spanish, Italian, or Portuguese housing market on Idealista usually means clicking through page after page and copying details by hand: price, size, bedrooms, the agency behind each listing. This scraper does the clicking for you. Paste an Idealista search URL and every listing comes back as a clean row, with price, area, location, and agency already split into fields and ready for a spreadsheet or a model. It runs fast, costs little, needs no code, and you only pay for what you scrape. ### What you get Each listing comes back as one row with three kinds of data: - **Identity and link** — `listingId`, `listingTitle`, `listingUrl`, `searchPageUrl`, `resultsPage` - **Price and size** — `priceValue`, `currencyCode`, `squareMeterPrice`, `bedroomCount`, `floorAreaSqm`, `featureChips` - **Listing and agency** — `summary`, `labelTags`, `imageLinks`, `coverImage`, `agentName`, `agentUrl`, `isPromoted`, `collectedAt` ### Quick start 1. Open Idealista, apply your filters (area, price, buy or rent), and copy the URL from the address bar. 2. Hit **Try for free** and paste that URL into **Search URLs**. 3. Set a **Results limit** to control how many listings you pull per URL. 4. Press **Start**, then export the results as JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Price tracking** — follow asking prices across a city or district and catch reductions early - **Area comparison** — line up price per m², bedroom counts, and sizes between neighbourhoods - **Investment research** — assemble a dataset of for-sale or rental stock to score against your own criteria - **Agency analysis** — see which agencies list what, where, and at what price - **Market dashboards** — pipe live Idealista data into your own sheet, BI tool, or app ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchUrls` | array of strings | Yes | Idealista search or listing URLs to scrape; each one runs on its own with full pagination. Works on the Spain, Italy, and Portugal editions and on buy, rent, or new-build searches. Prefilled with a Valencia for-sale search. | | `resultsLimit` | integer | No | How many listings to gather from each URL. Default `50`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before giving up. Default `45`. | #### Example input ```json { "searchUrls": [ "https://www.idealista.com/venta-viviendas/valencia-valencia/" ], "resultsLimit": 50, "timeoutSeconds": 45 } ```` ### Output Every listing on the search results becomes one row, paginated automatically up to your limit. Fields that Idealista does not show for a given property come back empty rather than guessed. #### Example output ```json { "listingId": "107654321", "listingTitle": "Piso en venta en calle de Colón, Eixample", "listingUrl": "https://www.idealista.com/inmueble/107654321/", "priceValue": 385000, "currencyCode": "EUR", "squareMeterPrice": 4280, "bedroomCount": 3, "floorAreaSqm": 90.0, "featureChips": ["3 hab.", "90 m²", "Garaje incluido"], "summary": "Luminoso piso reformado en pleno Eixample, a dos minutos del mercado de Colón.", "labelTags": ["Reformado", "Con ascensor"], "imageLinks": [ "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-1.jpg", "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-2.jpg" ], "coverImage": "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image/example-1.jpg", "agentName": "Inmobiliaria Mediterráneo", "agentUrl": "https://www.idealista.com/pro/inmobiliaria-mediterraneo/", "isPromoted": false, "searchPageUrl": "https://www.idealista.com/venta-viviendas/valencia-valencia/", "resultsPage": 1, "collectedAt": "2026-06-29T12:00:00.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Idealista's own identifier for the listing | | `listingTitle` | string | Property headline as printed on the result card | | `listingUrl` | string | Direct link to the property's detail page | | `priceValue` | integer | Asking price in euros | | `currencyCode` | string | Three-letter currency code, always EUR | | `squareMeterPrice` | integer | Asking price for each square metre, in euros | | `bedroomCount` | integer | How many bedrooms the property offers | | `floorAreaSqm` | number | Built area of the property in m² | | `featureChips` | array | Quick-detail chips on the card (garage, bedroom, size labels) | | `summary` | string | Short description snippet from the result card | | `labelTags` | array | Keyword badges attached to the listing | | `imageLinks` | array | Every photo URL found on the listing card | | `coverImage` | string | First photo URL, handy as a thumbnail | | `agentName` | string | Real estate agency behind the listing, when shown | | `agentUrl` | string | Link to the agency's profile on Idealista | | `isPromoted` | boolean | True when the listing ran as a featured result | | `searchPageUrl` | string | The results page this listing was pulled from | | `resultsPage` | integer | Which results page number the listing showed up on | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | ### Tips for best results - **Filter on Idealista first.** The tighter your search URL (area, price band, property type), the cleaner and more relevant your dataset. - **Use `resultsLimit` for test runs.** Start with 50 to check the output fits your pipeline, then raise it for the full pull. - **Buy and rent both work.** A `venta-viviendas` URL returns for-sale stock and an `alquiler-viviendas` URL returns rentals; the listing fields tell them apart. - **Some fields are sparse on certain cards.** A listing without an agency shows an empty `agentName`, and not every card carries `squareMeterPrice`; those rows still bring back everything else. - **Raise `timeoutSeconds`** if you see timeouts when pulling large result sets. ### How can I use Idealista property data? **How can I use the Idealista Property Scraper to track Spanish house prices?** Paste an Idealista search URL for your target area and run it on a schedule. Each row carries `priceValue`, `squareMeterPrice`, `listingTitle`, and `collectedAt`, so you can chart asking prices over time and flag the drops as they happen. **How can I compare neighbourhoods on Idealista by price per m²?** Pull listings for several areas and read `squareMeterPrice` straight from each row, or divide `priceValue` by `floorAreaSqm` yourself. With `bedroomCount` and `featureChips` alongside, you get a clean side-by-side look at where the value sits. **How can I build an Iberian real estate dataset for investment research?** Feed in one or more search URLs, set `resultsLimit` to the volume you need, and export to CSV or Excel. The result is a structured property database — price, size, location, agency — that you can score against your own buy criteria. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `searchUrls` (type: `array`): One or more Idealista search or listing page URLs. Works on every country edition of the site (Spain, Italy, Portugal) and any deal type, whether you want to buy, rent, or browse new builds. ## `resultsLimit` (type: `integer`): How many listings to gather from each URL. The count starts over for every URL you add. ## `timeoutSeconds` (type: `integer`): Seconds to wait on each request before giving up. Bump this up if you hit timeout errors on a slow connection. ## Actor input object example ```json { "searchUrls": [ "https://www.idealista.com/venta-viviendas/sevilla-sevilla/", "https://www.idealista.com/alquiler-viviendas/barcelona-barcelona/" ], "resultsLimit": 30, "timeoutSeconds": 45 } ``` # 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.idealista.com/venta-viviendas/valencia-valencia/" ] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/idealista-scraper-cheap").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.idealista.com/venta-viviendas/valencia-valencia/"] } # Run the Actor and wait for it to finish run = client.actor("data_api/idealista-scraper-cheap").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.idealista.com/venta-viviendas/valencia-valencia/" ] }' | apify call data_api/idealista-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/idealista-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Idealista Scraper (Cheap)", "description": "Idealista property scraper that collects prices, bedrooms, sizes, photos, and agency details from any search URL, so you can track asking prices and dig into the market without clicking through pages one by one.", "version": "0.0", "x-build-id": "hrstrrJzNYbXyaOJk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~idealista-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-idealista-scraper-cheap", "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/data_api~idealista-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-idealista-scraper-cheap", "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/data_api~idealista-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-idealista-scraper-cheap", "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": "Search URLs", "type": "array", "description": "One or more Idealista search or listing page URLs. Works on every country edition of the site (Spain, Italy, Portugal) and any deal type, whether you want to buy, rent, or browse new builds.", "items": { "type": "string" } }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many listings to gather from each URL. The count starts over for every URL you add.", "default": 30 }, "timeoutSeconds": { "title": "Timeout (seconds)", "minimum": 10, "maximum": 1200, "type": "integer", "description": "Seconds to wait on each request before giving up. Bump this up if you hit timeout errors on a slow connection.", "default": 45 } } }, "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 } } } } } } } } } } ```