Smart Idealista Scraper 🏠

🎉 NEW: CSV Bulk Upload - Analyze entire cities or regions at once! Upload unlimited locations via CSV file (Excel/Google Sheets friendly). Plus: 40 properties/page with automatic duplicate removal, 9 property categories, and 33% FREE bonus on every extraction!

Perfect for real estate professionals, investors, and market researchers who need reliable property data without the headache.

📋 Overview

Smart Idealista Scraper is ridiculously simple to use. No training required - just configure your search and get perfect property data instantly. Unlike complicated scrapers that break constantly, our API-based architecture never stops working.

Perfect for real estate professionals, investors, and market researchers who need reliable property data from Spain, Italy, and Portugal. Just configure, run, and download clean data in JSON or CSV format.

Why thousands of professionals choose us:

• ✅ Zero Learning Curve: Configure with filters, click Run, get results
• ⚡ Lightning Fast: 40 properties per page in seconds
• 🎯 API-Reliable: Never breaks - consistent data structure
• 💰 Best Price: $0.003/property + 33% bonus (40 delivered, 30 charged)
• 📁 CSV Bulk Upload: Analyze entire cities at once
• 🌍 3 Countries: Spain, Italy, Portugal covered
• 🚫 No Maintenance: No broken scrapers, no API keys to manage

✨ Revolutionary Features

• 📁 NEW: CSV Bulk Upload: Upload unlimited locations via Excel/Google Sheets-friendly CSV
• 🎯 Zero Learning Curve: Configure with filters, click Run, get perfect results
• ⚡ Instant Results: ~40 properties per page in seconds
• 🔄 Automatic Everything: No setup, no maintenance, no broken scrapers
• 📊 Perfect Data: Clean, structured output with 50+ data points
• 🌍 3 Countries Support: Spain, Italy, Portugal properties
• 💰 Best Price: $0.003/property + 33% bonus (40 delivered, 30 charged)
• 🚫 No Breakage: API-based architecture - never stops working
• 📈 Multi-page: Extract hundreds of properties automatically
• 🏘️ 9 Categories: Homes, offices, land, garages, commercial, rooms

🎬 Quick Start

So simple, no training needed! Just provide location details and run.

# Using API
curl -X POST https://api.apify.com/v2/acts/sian.agency/smart-idealista-scraper/runs?token=[YOUR_TOKEN] \
-d '{
  "country": "es",
  "operation": "rent",
  "locationId": "0-EU-ES-28-07-001-079",
  "locationName": "Madrid",
  "numPages": 2
}'

🚀 Getting Started (2 Simple Steps)

Step 1: Choose Your Input Mode

Option A: Single Location - Perfect for targeted searches

• Provide country, operation, locationId, locationName
• Add filters (price, size, bedrooms, etc.)
• Specify numPages (1-250)

Option B: 🆕 CSV Bulk Upload - Ideal for city/region analysis

• Upload CSV with locationId and locationName columns
• Excel/Google Sheets friendly
• PAID tier only - unlimited locations

Step 2: Click Run & Download

One click and our API gets to work instantly. Download clean JSON or CSV with 50+ data points per property.

That's it! In seconds, you'll have:

• Complete property data (price, size, rooms, features)
• Location information (address, coordinates, neighborhood)
• Contact details (agency, phone, website)
• Media URLs (photos, videos, virtual tours)
• Auto-calculated metrics (price per m²)

📥 Input Configuration

Field	Type	Required	Description
country	string	Yes	Country code: es (Spain), it (Italy), pt (Portugal)
operation	string	Yes	Operation type: sale or rent
locationId	string	Yes	Idealista location ID (hierarchical format)
locationName	string	Yes	Human-readable location name
endpoint	string	No	Property category (default: listhomes)
numPages	integer	No	Number of pages to scrape (1-250, default: 1)
order	string	No	Sort order (default: mostrecent)
language	string	No	Result language (default: en)

Property Categories (endpoint):

• listhomes - All homes (apartments, houses) [Default]
• listnewhomes - New developments
• liststoragerooms - Storage rooms
• listbuildings - Buildings
• listlands - Land parcels
• listgarages - Garages/Parking
• listcommercialproperties - Commercial properties
• listoffices - Office spaces
• listrooms - Individual rooms

Location ID Format:

• Spain: 0-EU-ES-XX-YYY-ZZZ (e.g., 0-EU-ES-28-07-001-079 = Madrid)
• Italy: 0-EU-IT-XX-YYY-ZZZ (e.g., 0-EU-IT-RM-01-001 = Rome)
• Portugal: 0-EU-PT-XX-YYY (e.g., 0-EU-PT-11 = Lisbon)

How to find Location ID: Go to idealista.com → search → DevTools (F12) → Network tab → Find locationId in API calls

CSV Bulk Upload: Upload file with locationId,locationName columns (headers optional)

Search Filters (64+ available):

• Price: minPrice, maxPrice
• Size: minSize, maxSize
• Bedrooms/Bathrooms: bedrooms0-4, bathrooms1-3
• Property Types: flat, penthouse, duplex, chalet, villaType, etc.
• Condition: newDevelopment, good, renew, furnished
• Features: airConditioning, elevator, garage, pool, garden
• Floor/Time: topFloor, intermediateFloor, sinceDate
• Rental: longTermResidential, shortTerm
• Advanced: micrositeShortName (agency filter), center (GPS), distance

📤 Output

Field	Type	Description
propertyCode	string	Unique Idealista ID
title	string	Property title
price	number	Price in EUR
size	number	Size in square meters
pricePerSqm	number	Price per square meter (auto-calculated)
rooms	number	Number of rooms
bathrooms	number	Number of bathrooms
address	string	Full address
neighborhood	string	Neighborhood name
district	string	District
municipality	string	City/Municipality
province	string	Province/State
country	string	Country code
locationId	string	Idealista location ID
latitude	number	GPS latitude
longitude	number	GPS longitude
description	string	Full property description
url	string	Property URL
thumbnail	string	Main image URL
images	array	All image URLs
propertyType	string	Type (flat, house, etc.)
operation	string	Sale or rent
numPhotos	number	Number of photos
hasVideo	boolean	Has video tour
has3DTour	boolean	Has 3D tour
hasPlan	boolean	Has floor plan
features	object	All features object
agencyName	string	Agency name
agencyUrl	string	Agency website

Example:

{
  "propertyCode": "103887563",
  "title": "Studio apartment in paseo de Juan Antonio Vallejo-Nájera Botas, 29",
  "subtitle": "Acacias, Madrid",
  "price": 950,
  "size": 30,
  "pricePerSqm": 32,
  "rooms": 0,
  "bathrooms": 1,
  "address": "paseo de Juan Antonio Vallejo-Nájera Botas, 29",
  "district": "Arganzuela",
  "neighborhood": "Acacias",
  "municipality": "Madrid",
  "province": "Madrid",
  "country": "es",
  "locationId": "0-EU-ES-28-07-001-079-02-002",
  "latitude": 40.4022241,
  "longitude": -3.7099448,
  "description": "INDIVIDUAL RENT furnished studio...",
  "url": "https://www.idealista.com/inmueble/103887563/",
  "thumbnail": "https://img4.idealista.com/blur/480_360_mq/...",
  "propertyType": "studio",
  "operation": "rent",
  "numPhotos": 17
}

💼 Use Cases & Examples

Real Estate Market Analysis

Extract property prices and features for market research across multiple locations.

Input: Country + location + price/size filters Output: Property data with price per m² analysis Use: Market reports, price trends, investment analysis

Investment Property Search

Find rental properties with specific ROI criteria.

Input: Operation=rent + max price + bedrooms + amenities Output: Matching properties with yield calculations Use: Investment analysis, rental yield projections

Competitive Analysis

Monitor competitor listings and pricing strategies.

Input: Location + agency filter + sort order Output: Competitor's full portfolio with pricing Use: Pricing strategy, market positioning

Multi-Location Market Research

Analyze entire cities or regions at once.

Input: CSV file with multiple locations + filters Output: Consolidated data across all locations Use: Regional analysis, expansion planning

Price Per m² Benchmarks

Calculate accurate price-per-square-meter across neighborhoods.

Input: Location + property type filters Output: Properties with auto-calculated pricePerSqm Use: Valuation benchmarks, fair price analysis

New Development Tracking

Monitor new construction projects in target areas.

Input: Endpoint=listnewhomes + location Output: All new development listings Use: Market supply analysis, upcoming inventory

🔗 Integration Examples

JavaScript/Node.js

const { ApifyClient } = require('apify-client');
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/smart-idealista-scraper').call({
  country: 'es',
  operation: 'rent',
  locationId: '0-EU-ES-28-07-001-079',
  locationName: 'Madrid',
  numPages: 3,
  maxPrice: 2000,
  bedrooms2: true
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} properties`);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/smart-idealista-scraper').call(
    run_input={
        'country': 'es',
        'operation': 'sale',
        'locationId': '0-EU-ES-46-07-001-001',
        'locationName': 'Valencia',
        'numPages': 2,
        'minPrice': 250000,
        'maxPrice': 350000
    }
)

items = client.dataset(run['defaultDatasetId']).list_items().items
print(f"Found {len(items)} properties")

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency/smart-idealista-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "country": "it",
  "operation": "sale",
  "locationId": "0-EU-IT-MI-01-001",
  "locationName": "Milan",
  "numPages": 1,
  "flat": true
}'

Automation Tool Workflows (n8n, Zapier, Make, etc.)

1. Trigger: Manual/schedule/webhook
2. HTTP Request: Call this actor's API
3. Process: Filter and analyze properties
4. Action: Save to database, send alerts, generate reports

📊 Performance & Pricing

View current pricing in the Apify Console

Performance

• Speed: ~40 properties per page (15-20 seconds)
• Concurrent runs: FREE=1, PAID=5
• Timeout: 7 days (for large extractions)
• Reliability: API-based - never breaks

Pricing Model

• Start Fee: $0.005 per run
• Per Property: $0.003
• 🎁 Launch Bonus: Get 33% more properties FREE!
  • You pay for 30 properties/page
  • You get 40 properties/page

Cost Examples

• 1 page (40 properties): $0.095
• 5 pages (200 properties): $0.455
• 10 pages (400 properties): $0.905

Tier Limits

• FREE: ~200 properties/month recommended
• PAID: Unlimited properties, CSV bulk upload

❓ Frequently Asked Questions

Q: How do I find my Location ID? A: Go to idealista.com, search for your location, open DevTools (F12), look at Network tab during search, find locationId in API calls.

Q: Can I extract from private listings? A: Only public listings are accessible. No authentication required.

Q: How many properties can I extract? A: FREE tier: ~200/month recommended. PAID tier: unlimited.

Q: Is the data reliable? A: Yes! We use API-based architecture, never screen scraping. No breakage, consistent data structure.

Q: Is this an Idealista API? A: Idealista doesn't offer a public API. Smart Idealista Scraper is the most reliable Idealista API alternative — it extracts the same structured property data you see on idealista.com (Spain), idealista.it (Italy), and idealista.pt (Portugal), delivered as clean JSON with 50+ fields per property. Use it whenever you'd otherwise want an "Idealista API" or "idealista data" feed.

Q: Can I export to Excel? A: Yes! Download as CSV and open directly in Excel.

Q: How fast is it? A: Approximately 15-20 seconds per page, delivering 40 properties each.

Q: Does it work with GPS coordinates? A: Yes! Use center (lat,lng) and distance (radius in meters) instead of locationId.

Q: What's the CSV upload format? A: Simple CSV with locationId,locationName columns. Headers optional. Excel/Google Sheets friendly.

🐛 Troubleshooting

No results returned

• Verify locationId format (hierarchical code)
• Check if location exists in that country
• Try with broader search filters

Invalid locationId error

• Double-check the location ID format
• Ensure country code matches location
• Use DevTools to extract correct location ID

Rate limiting on FREE tier

• Monitor your monthly usage
• Upgrade to PAID for unlimited access
• Use specific filters to reduce results

Timeout errors

• Reduce numPages per run
• Use multiple smaller runs
• Check if N8N is responding

Unexpected property types

• Verify endpoint parameter
• Check property type filters
• Review location for property availability

🇪🇸 Idealista API & Data Extraction — Para Usuarios en España

Looking for an Idealista API, a way to scrape Idealista listings, or to extract Idealista data? Smart Idealista Scraper is the most reliable Idealista scraper available — structured JSON output, no breakage, no coding. Built for Spanish real estate professionals, developers, and investors who need clean property data from idealista.com.

¿Buscas una API de Idealista o una forma fiable de extraer datos de Idealista? Smart Idealista Scraper te entrega datos estructurados de propiedades de idealista.com sin código, sin mantenimiento y con datos siempre limpios. Es la alternativa más fiable a una API oficial (que Idealista no ofrece públicamente).

Why this Idealista scraper works

• ✅ Idealista API alternative: Idealista datos en JSON estructurado, 50+ campos por propiedad
• ⚡ 40 propiedades por página en segundos
• 💰 $0.003 por propiedad + 33% gratis (paga 30, recibe 40)
• 📁 Carga masiva CSV: analiza ciudades enteras de una vez
• 🎯 API-reliable: nunca se rompe — datos consistentes

Quick example — extract Idealista data for Madrid (alquiler)

curl -X POST 'https://api.apify.com/v2/acts/sian.agency/smart-idealista-scraper/runs?token=TU_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "country": "es",
  "operation": "rent",
  "locationId": "0-EU-ES-28-07-001-079",
  "locationName": "Madrid",
  "numPages": 2,
  "maxPrice": 1500
}'

Casos de uso comunes en España

• Análisis de mercado: precios, tendencias y comparativas por barrio
• Inversión inmobiliaria: encuentra propiedades de alquiler con ROI específico
• Análisis competitivo: monitoriza listados de inmobiliarias y cambios de precio
• Valoración por m²: calcula precio por metro cuadrado con precisión
• Obra nueva: descubre nuevas promociones (endpoint: listnewhomes)

FAQ — España

• ¿Cómo encuentro mi locationId? Ve a idealista.com → busca tu zona → DevTools (F12) → pestaña Network → busca locationId en las llamadas API.
• ¿Funciona con coordenadas GPS? Sí, usa center (lat,lng) y distance (radio en metros).
• ¿Puedo exportar a Excel? Sí, descarga en CSV y ábrelo directamente en Excel o Google Sheets.
• ¿Es legal? Solo se accede a listados públicos de idealista.com. Es responsabilidad del usuario cumplir con el RGPD y los términos de uso.

🇮🇹 Per utenti in Italia

Smart Idealista Scraper supporta anche idealista.it — stesso prezzo, stesse funzionalità. Esempio rapido per Milano in vendita:

curl -X POST 'https://api.apify.com/v2/acts/sian.agency/smart-idealista-scraper/runs?token=IL_TUO_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
  "country": "it",
  "operation": "sale",
  "locationId": "0-EU-IT-MI-01-001",
  "locationName": "Milano",
  "numPages": 2,
  "flat": true
}'

---

Built by SIÁN Agency | More Tools

🎯 Not sure which tier you need? Start with FREE - no credit card required. Upgrade when you're ready to scale!