Idealista Property Scraper

Collect property listings from Idealista (Spain, Italy, Portugal) — price, location, rooms, size, floor, description, and the listing agency — from any Idealista search you can build on the site. Works for sale and rent. No account or login required.

Why use this actor

• No account needed — works on public search pages.
• Any search, any filters — paste an Idealista search URL (location, sale/rent, price, rooms) and the actor collects every result.
• Full listing details — price, rooms, size (m²), floor, parking, description, and the listing agency.
• Spain, Italy & Portugal — works across idealista.com / .it / .pt.
• Stable JSON output — ready for spreadsheets, dashboards, or market analysis.
• Handles the site's protection automatically — you don't manage browsers, sessions, or retries.

How it works

1. Open Idealista, set your filters (location, sale/rent, price, rooms), and copy the address-bar URL.
2. Paste one or more of those URLs into Search URLs.
3. The actor collects every listing across the result pages, turning pages automatically until your limit.
4. Each listing becomes one row — downloadable as JSON, CSV, or Excel.

A residential proxy in the site's country (Spain for idealista.com) is required and set by default.

Use cases

• Real-estate market analysis — track pricing, inventory, and size trends by area.
• Lead generation — collect listings and the agencies behind them.
• Investment research — filter by price/size/rooms across neighbourhoods.
• Portals & aggregators — feed Idealista inventory into your own product.

Input

{
  "startUrls": ["https://www.idealista.com/venta-viviendas/madrid-madrid/"],
  "maxItemsPerSearch": 0,
  "maxItems": 100,
  "maxPagesPerSearch": 60,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES" }
}

Field	Type	Description
startUrls	array	Idealista search-result URLs with filters applied. Copy from the site's address bar.
maxItemsPerSearch	integer	Cap listings per search URL. 0 = all (up to the page limit).
maxItems	integer	Overall cap for the run. 0 = no limit. Default 100.
maxPagesPerSearch	integer	Safety cap on result pages per search. Default 60.
proxyConfiguration	object	Residential proxy required; match the site's country (the default is Spain).

Output

One record per listing:

{
  "_input": "https://www.idealista.com/venta-viviendas/madrid-madrid/",
  "_scrapedAt": "2026-06-16T13:30:00Z",
  "recordType": "LISTING",
  "id": "111756738",
  "url": "https://www.idealista.com/inmueble/111756738/",
  "title": "Piso en Calle de Fernández de la Hoz, Almagro, Madrid",
  "priceText": "1.950.000€", "price": 1950000,
  "rooms": 4, "sizeM2": 175, "floor": "5ª planta exterior con ascensor", "hasParking": true,
  "description": "ÚNICA inmobiliaria presenta esta extraordinaria vivienda señorial ...",
  "agency": "Única Consultoría Inmobiliaria",
  "tags": [],
  "detailsRaw": ["Garaje incluido", "4 hab.", "175 m²", "5ª planta exterior con ascensor"]
}

Field	Type	Description
id / url	string	Listing ID and link.
title	string	Listing headline (street / area).
priceText / price	string / number	Price as shown, and as a plain number.
rooms / sizeM2 / floor / hasParking	mixed	Parsed property details.
description	string	Listing description.
agency	string	Listing agency (when shown).
tags	array	Listing badges.
detailsRaw	array	The raw detail chips, as shown on the card.

Searches that fail are returned with an _error field, so nothing fails silently.

Notes

• Use a residential proxy in the site's country. For idealista.it / .pt, set the proxy country to IT / PT.
• Idealista shows ~30 listings per page; very large searches are capped by the site itself (use tighter filters to go deeper).