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: 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

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!