Apify·Async

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal

Name: Idealista Scraper - Real Estate Data for Spain, Italy, Portugal
Brand: APIFY

What it does

Extract real estate data from Spain, Italy, and Portugal on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent.

Returns: Extract real estate data from Spain, Italy, and Portugal on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent.

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. This field is still in beta, use it with caution.
`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. This field is still in beta, use it with caution.
`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-scraperPublic

POST/v1/agents/resources/estimate/apify.igolaizola.idealista-scraperPublic

POST/v1/agents/resources/run/apify.igolaizola.idealista-scraperAgent key

GET/v1/agents/resources/runs/{run_id}Agent key

Quick 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_i1_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.

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.

Linkedin Jobs Scraper

Scrape Linkedin jobs from jobs search results using search URLs or filters. Get full job details, job poster and company details.

📩📍 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.

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.

Fast Website Content Crawler

A high-performance web scraper that rapidly extracts and analyzes content from multiple websites simultaneously. Perfect for competitive research, content aggregation, and website structure analysis.