Package Information
Released: 6 mo ago
Downloads: 18 weekly / 65 monthly
Latest Version: 0.1.4
Author: SIÁN Agency
Documentation
n8n-nodes-idealista-scraper
This is an n8n community node that lets you scrape property listings from Idealista (Spain, Italy, Portugal) using the Smart Idealista Scraper on Apify.
n8n is a fair-code licensed workflow automation platform.
Features
- Search properties across Spain, Italy, and Portugal
- 9 property categories: homes, new homes, storage rooms, buildings, lands, garages, commercial, offices, rooms
- 64+ search filters: price, size, bedrooms, bathrooms, property types, amenities, and more
- Multi-page scraping: up to 250 pages per run (~40 properties per page)
- Automatic deduplication: removes duplicate listings across pages
- Returns structured JSON data ready for downstream processing
Installation
Follow the installation guide in the n8n community nodes documentation.
Package name: n8n-nodes-idealista-scraper
Prerequisites
You need an Apify account and API token:
- Sign up at apify.com
- Go to Settings > Integrations in the Apify Console
- Copy your API token
- In n8n, create an Apify API credential and paste the token
Usage
- Add the Idealista Scraper node to your workflow
- Configure the required fields:
- Country — Spain, Italy, or Portugal
- Operation — Buy/Sale or Rent
- Location ID — Idealista location code (e.g.,
0-EU-ES-28-07-001-079for Madrid) - Location Name — Human-readable name (e.g., "Madrid")
- Optionally expand filter sections to refine your search
- Execute the node — it will start an Apify actor run and return the property data
Finding a Location ID
- Go to idealista.com and search for your target area
- Open browser DevTools (F12) > Network tab
- Look for API calls containing
locationId=parameter - Copy the full location code
Common formats:
- Spain:
0-EU-ES-XX-YYY(e.g.,0-EU-ES-28-07-001-079for Madrid) - Italy:
0-EU-IT-XX-YYY(e.g.,0-EU-IT-RM-01-001for Rome) - Portugal:
0-EU-PT-XX(e.g.,0-EU-PT-11for Lisbon)
Available Filters
| Category | Filters |
|---|---|
| Price | Min/max price (EUR) |
| Size | Min/max size (m²) |
| Bedrooms | Studio, 1-4+ bedrooms |
| Bathrooms | 1-3+ bathrooms |
| Property Types | Flats, penthouses, duplexes, chalets, villas, lofts, cortijos, and more |
| Condition | New development, good condition, to renew, furnished status |
| Features | A/C, elevator, garage, pool, terrace, garden, pets allowed, and more |
| Floor & Time | Top/intermediate floor, published since (24h/48h/week/month) |
| Rental | Long-term residential, short-term/seasonal |
| Advanced | Agency filter, GPS coordinates + radius search |
Execution Control
| Setting | Default | Description |
|---|---|---|
| Timeout | 300s | Max wait time for results (60-1800s) |
| Max Results | 0 (all) | Limit returned properties |
Pricing
This node uses the Smart Idealista Scraper on Apify:
- $0.005 per actor run
- $0.003 per property extracted
- Each page returns ~40 properties (charged for 30, 10 bonus free)
Output
Each property includes: price, size, rooms, bathrooms, address, coordinates, images, agent info, property features, and more. See the actor documentation for the full output schema.