← API Catalog
Apify·Async
Idealista Scraper - Real Estate for Spain Italy Portugal France
Knowledge & Data$0.00055 / Result
What it does
Extract real estate data from Spain, Italy, Portugal, and France on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent. Results as JSON, CSV or Excel. Access through API or MCP.
Returns: Extract real estate data from Spain, Italy, Portugal, and France on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent. Results as JSON, CSV or Excel. Access through API or MCP.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
lift | boolean | No | Whether the property has a lift |
plan | boolean | No | Whether the property has a floor plan |
floor | select | No | Floor of the property |
agency | text | No | Filter properties by agency. Use the slug from the agency page URL, e.g., engel-volkers in https://www.idealista.com/pro/engel-volkers/. |
garage | boolean | No | Whether the property has garage or parking space |
garden | boolean | No | Whether the property has a garden |
luxury | boolean | No | Whether the property is a luxury home |
sortBy | select | No | Sorting method for results |
balcony | boolean | No | Whether the property has a balcony |
country | select | Yes | Select your country |
maxSize | select | No | Maximum size of the property (0 for any) |
minSize | select | No | Minimum size of the property (0 for any) |
terrace | boolean | No | Whether the property has a terrace |
bedrooms | select | No | Number of bedrooms |
exterior | boolean | No | Whether the property is exterior |
homeType | select | No | Home types to search |
latitude | number | No | Latitude of the center point for coordinate-based search. Use together with longitude. When set, coordinates take precedence over location and locations. |
location | text | No | Location to search. Use a city name (e.g. Madrid), an Idealista Location ID (e.g. 0-EU-ES-28-07-001-079), or leave empty to scrape every province in the selected country. Ignored when Locations has at least one value. Use [Idealista Location Search Tool](https://igolaizola.github.io/idealista-scraper) to find a specific Location ID. |
maxItems | number | No | Maximum number of items to scrape (0 for unlimited). Large searches use the default iterator to continue past Idealista's 2500-result page window. |
maxPrice | select | No | Maximum price of the property (0 for any) |
minPrice | select | No | Minimum price of the property (0 for any) |
seaViews | boolean | No | Whether the property has sea views |
bankOffer | boolean | No | Whether the property is bank-owned |
bathrooms | select | No | Number of bathrooms |
condition | select | No | Condition types to search |
locations | array | No | Locations to search for properties. When this list has at least one value, the actor searches each location in order instead of using Location. |
longitude | number | No | Longitude of the center point for coordinate-based search. Use together with latitude. |
operation | select | Yes | Operation type to search (sale, rent) |
accessible | boolean | No | Whether the property is an accessible property |
distanceKm | number | No | Search radius around the latitude/longitude point, in kilometers. |
fetchStats | boolean | No | Whether to fetch statistics for each property. Each property will have an extra field '_stats' in the results. |
postalCodes | array | No | Postal codes to search in order. Idealista resolves each one to a matching search area. Takes precedence over location, locations, and coordinates. maxItems applies globally. |
rentalTypes | select | No | Rental usage type |
storageRoom | boolean | No | Whether the property has a storage room |
virtualTour | boolean | No | Whether the property has a virtual tour |
fetchDetails | boolean | No | Whether to fetch detailed information for each property. Each property will have an extra field '_details' in the results. |
propertyType | select | Yes | Property type to search (newDevelopments, homes, bedrooms, vacationRentals, garages, storageRooms, offices, premises, transfers, lands, buildings) |
swimmingPool | boolean | No | Whether the property has a swimming pool |
propertyCodes | array | No | List of Idealista property codes to fetch directly. When set, location and all filters are ignored. Each result will include '_details' (always) and '_stats' if fetchStats is enabled. |
splitLocation | boolean | No | Use the old sub-location splitting mode for backward compatibility. The default iterator is recommended for large scrapes and can continue without the 2500-result page limit. |
propertyStatus | select | No | Status of the property |
airConditioning | boolean | No | Whether the property has air conditioning |
fittedWardrobes | boolean | No | Whether the property has fitted wardrobes |
publicationDate | select | No | Publication date of the property |
Endpoints
GET
/v1/agents/resources/inspect/apify.igolaizola.idealista-scraperPublicPOST
/v1/agents/resources/estimate/apify.igolaizola.idealista-scraperPublicPOST
/v1/agents/resources/run/apify.igolaizola.idealista-scraperAgent keyGET
/v1/agents/resources/runs/{run_id}Agent keyQuick start
Run it with one Agent One Key over the OpenAI-compatible resource rail.
curl -X POST https://api.deva.me/v1/agents/resources/run/apify.igolaizola.idealista-scraper \
-H "Authorization: Bearer deva_your_key_here" \
-H "Content-Type: application/json" \
--data '{
"params": {}
}'Related in Knowledge & Data
Zillow Detail Scraper
Get details of Zillow properties from URLs. This Actor can be easily integrated with other Zillow Scrapers.
🔥 LinkedIn Jobs Scraper
ℹ️ Designed for both personal and professional use, simply enter your desired job title and location to receive a tailored list of job opportunities. Try it today!
Linkedin Jobs Scraper
Scrape Linkedin jobs from jobs search results using search URLs or filters. Get full job details, job poster and company details.
Posts Search Scraper for LinkedIn | No Cookies
Scrape LinkedIn posts by keyword without login. Get post content, reactions, author details, and media. Sort by relevance or date. Perfect for research, analysis, and monitoring trends.
Indeed Scraper
Scrape jobs posted on Indeed. Get detailed information from this job portal about saved and sponsored jobs. Specify the search based on location with the output attributes position, location, and description.
📩📍 Google Maps Email Extractor
Extract Google Maps contact details. Scrape websites of Google Maps places for contact details and get email addresses, website, location, address, zipcode, phone number, social media links. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.