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:

1. Sign up at apify.com
2. Go to Settings > Integrations in the Apify Console
3. Copy your API token
4. In n8n, create an Apify API credential and paste the token

Usage

1. Add the Idealista Scraper node to your workflow
2. 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-079 for Madrid)
   • Location Name — Human-readable name (e.g., "Madrid")
3. Optionally expand filter sections to refine your search
4. Execute the node — it will start an Apify actor run and return the property data

Finding a Location ID

1. Go to idealista.com and search for your target area
2. Open browser DevTools (F12) > Network tab
3. Look for API calls containing locationId= parameter
4. Copy the full location code

Common formats:

• Spain: 0-EU-ES-XX-YYY (e.g., 0-EU-ES-28-07-001-079 for Madrid)
• Italy: 0-EU-IT-XX-YYY (e.g., 0-EU-IT-RM-01-001 for Rome)
• Portugal: 0-EU-PT-XX (e.g., 0-EU-PT-11 for 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.

Resources

• Smart Idealista Scraper on Apify
• Apify API Documentation
• n8n Community Nodes Documentation

License

MIT