Smart Idealista Scraper 🏠

Extract 1000+ property listings from Idealista (Spain, Italy, Portugal) in minutes. API-reliable with no breakage. Best price: $0.003/property + 33% FREE bonus! 64+ filters, clean JSON/CSV, zero technical skills needed.

📋 Overview

Smart Idealista Scraper is ridiculously simple to use. No training required - just configure your search parameters and get perfect property data instantly. Unlike complicated tools that require hours of learning, our actor works in seconds and never breaks.

Perfect for real estate professionals, investors, and market researchers who need reliable property data without the headache. Just configure, run, and download your clean data in JSON or CSV format.

✨ Features

• 🎯 Zero Learning Curve: Configure search with 64+ filters, click Run, get results
• ⚡ Instant Results: Extract 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 Scraping: Extract hundreds of properties automatically
• 🏘️ 9 Property Categories: Homes, offices, land, garages, and more

🎬 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
}'

📥 Input Configuration

Required Fields

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

Core Options

Field	Type	Default	Description
endpoint	string	listhomes	Property category (9 options)
numPages	integer	1	Number of pages to scrape (1-250)
order	string	mostrecent	Sort order (12 options)
language	string	en	Result language (9 options)

Property Categories (endpoint)

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

Location ID Format

Idealista uses hierarchical location codes:

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

1. Go to idealista website and search for your location
2. Open browser DevTools (F12) → Network tab
3. Search for any property
4. Look for API calls containing locationId= parameter
5. Copy the full location code

Common Location IDs:

• Madrid, Spain: 0-EU-ES-28-07-001-079
• Barcelona, Spain: 0-EU-ES-08-01-001-001
• Valencia, Spain: 0-EU-ES-46-07-001-001
• Rome, Italy: 0-EU-IT-RM-01-001
• Milan, Italy: 0-EU-IT-MI-01-001
• Lisbon, Portugal: 0-EU-PT-11

Search Filters (64+ options)

💰 Price Filters

• minPrice - Minimum price in EUR
• maxPrice - Maximum price in EUR

📏 Size Filters

• minSize - Minimum size in square meters
• maxSize - Maximum size in square meters

🛏️ Bedrooms & Bathrooms

• bedrooms0-4 - Number of bedrooms (studio to 4+)
• bathrooms1-3 - Number of bathrooms (1 to 3+)

🏢 Property Types

• flat - All apartment types
• penthouse - Penthouses
• duplex - Duplex apartments
• chalet - All house types
• independantHouse - Detached houses
• semidetachedHouse - Semi-detached
• terracedHouse - Terraced houses
• countryHouse - Country houses
• villaType - Villas
• loftType - Lofts
• And 7 more specialized types...

🏗️ Property Condition

• newDevelopment - New builds only
• good - Good condition
• renew - Needs renovation
• furnished - Furnishing status
• isBareOwnership - Bare ownership
• And 4 more status options...

✨ Features & Amenities

• airConditioning - Air conditioning
• elevator - Building has elevator
• garage - Has garage/parking
• swimmingPool - Has swimming pool
• garden - Has garden
• terrace - Has terrace
• storeRoom - Has storage room
• And 10 more features...

🏢 Floor & Time

• topFloor - Top floor only
• intermediateFloor - Intermediate floors
• sinceDate - Publication date filter

🏡 Rental Options

• longTermResidential - Long-term rentals
• shortTerm - Short-term/seasonal

🏢 Advanced Filters

• micrositeShortName - Filter by agency
• center - GPS coordinates (lat,lng)
• distance - Search radius in meters

📤 Output Schema

Each property includes 50+ data points:

Core Information

• propertyCode - Unique Idealista ID
• title - Property title
• description - Full description
• url - Property URL
• thumbnail - Main image URL
• images - All image URLs

Property Details

• propertyType - Type (flat, house, etc.)
• price - Price in EUR
• size - Size in square meters
• pricePerSqm - Price per square meter (auto-calculated)
• rooms - Number of rooms
• bathrooms - Number of bathrooms
• floor - Floor number

Location

• address - Full address
• neighborhood - Neighborhood name
• district - District
• municipality - City/Municipality
• province - Province/State
• country - Country
• locationId - Idealista location ID
• latitude - GPS latitude
• longitude - GPS longitude

Features & Status

• exterior - Exterior-facing
• hasLift - Has elevator
• newDevelopment - New build
• propertyStatus - Current status
• features - All features object
• newProperty - Newly listed

Media & Tours

• numPhotos - Number of photos
• hasVideo - Has video tour
• has3DTour - Has 3D tour
• hasPlan - Has floor plan
• videoUrl - Video URL

Contact Information

• agencyName - Agency name
• agentName - Agent name
• agentPhone - Phone number
• agencyUrl - Agency website
• isAgency - Professional listing

Metadata

• firstActivationDate - Original listing date
• operation - Sale/rent
• processedAt - Extraction timestamp
• searchParams - Search parameters used

💼 Use Cases & Examples

Real Estate Market Analysis

Extract property prices and features for market research.

Input:

{
  "country": "es",
  "operation": "sale",
  "locationId": "0-EU-ES-28-07-001-079",
  "locationName": "Madrid",
  "numPages": 5,
  "flat": true,
  "minPrice": 200000,
  "maxPrice": 400000
}

Output: 200 properties with price analysis, price per m², location data Use: Market reports, price trends, investment analysis

Investment Property Search

Find rental properties with specific ROI criteria.

Input:

{
  "country": "pt",
  "operation": "rent",
  "locationId": "0-EU-PT-11",
  "locationName": "Lisbon",
  "numPages": 3,
  "maxPrice": 1500,
  "bedrooms2": true,
  "bedrooms3": true,
  "elevator": true
}

Output: 120 rental properties matching criteria Use: Investment calculations, rental yield analysis

Competitive Analysis

Monitor competitor listings and pricing.

Input:

{
  "country": "it",
  "operation": "sale",
  "locationId": "0-EU-IT-RM-01-001",
  "locationName": "Rome",
  "numPages": 2,
  "micrositeShortName": "agency-name",
  "order": "lowestprice"
}

Output: 80 properties from specific agency Use: Competitor monitoring, pricing strategy

🔗 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
});

// Get results
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
    }
)

# Get results
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
}'

N8N Workflow

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

📊 Performance & Pricing

Speed & Capacity

• Speed: ~40 properties per page (15-20 seconds)
• FREE tier: ~200 properties/month recommended
• PAID tier: Unlimited properties
• Concurrent runs: FREE=1, PAID=5
• Timeout: 7 days (for large extractions)

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
  • Example: 3 pages = $0.005 + (90 × $0.003) = $0.275 for 120 properties!

Cost Examples

• 1 page (40 properties): $0.005 + (30 × $0.003) = $0.095
• 5 pages (200 properties): $0.005 + (150 × $0.003) = $0.455
• 10 pages (400 properties): $0.005 + (300 × $0.003) = $0.905

Best Practices

1. Start Small: Test with 1 page first
2. Use Filters: Narrow search to save costs
3. Check Location ID: Verify correct location format
4. Monitor Usage: Track FREE tier limits

❓ 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 30 properties each.

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

Q: Are there any legal restrictions? A: Public data extraction is generally legal for research purposes. Respect rate limits and terms of service.

🐛 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

💰 Pricing Plans

FREE Plan

• Cost: Pay-per-use only
• Properties: ~200/month recommended
• Concurrent runs: 1
• Support: Community support
• Best for: Testing, small projects

PAID Plan

• Cost: Pay-per-use only
• Properties: Unlimited
• Concurrent runs: 5
• Support: Priority email support
• Best for: Professionals, regular use

Enterprise

• Cost: Custom pricing
• Properties: Unlimited
• Concurrent runs: Unlimited
• Support: Dedicated support + SLA
• Features: Custom integrations, monitoring

🔒 Privacy & Compliance

• GDPR Compliant: Only processes public listing data
• Data Security: Encrypted transmission and storage
• Data Retention: Results stored for 30 days
• User Rights: Download/delete your data anytime
• Legal: Public data extraction for research purposes

⚖️ Legal Disclaimer

Important Notice: This tool extracts publicly available property listings from Idealista for research and analysis purposes. Users are responsible for:

1. Compliance: Ensure your use complies with local laws and Idealista's terms of service
2. Data Usage: Use extracted data responsibly and ethically
3. Rate Limits: Respect platform rate limits and fair use policies
4. Commercial Use: Check commercial use restrictions in your jurisdiction

The tool only accesses data that is publicly available on Idealista's website. We do not bypass any authentication or access private data.

By using this tool, you acknowledge that:

• You are extracting public data for legitimate purposes
• You will comply with applicable laws and regulations
• You understand that web scraping regulations vary by country
• You are responsible for how you use the extracted data

For more information about web scraping legality, please refer to Apify's guide: Is Web Scraping Legal?

Built by SIAN Agency | More Real Estate Tools

Real Estate Professionals Trust Us ✓ API-Reliable ✓ Best Price ✓ Zero Technical Skills Required