Pricing
from $20.00 / 1,000 results
Idealista Property Scraper
Collect property listings from Idealista (Spain, Italy, Portugal) β price, location, rooms, size, floor, description, and listing agency β from any search URL. For sale or rent.
Pricing
from $20.00 / 1,000 results
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
4
Total users
2
Monthly active users
12 days ago
Last modified
Categories
Share
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
- Open Idealista, set your filters (location, sale/rent, price, rooms), and copy the address-bar URL.
- Paste one or more of those URLs into Search URLs.
- The actor collects every listing across the result pages, turning pages automatically until your limit.
- 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).
